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SPECIAL NOTICE TO 
CAL/32 USERS 


The CAL/32 assembler is not compatible with the CAL 
assembler in the handling of unreferenced externals. In 
order to support weak externals, object code will be 
generated for unreferenced externals. Programs assembled 
by CAL/32 and containing unreferenced externals to 
nonexistent modules will receive an error message at Link 
time. For compatibility with CAL, the NUREX start 
option/assembler instruction has been introduced in 
CAL/32. 
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PREFACE 


This manual describes the Perkin-Elmer Common Assembly 
Language/32 (CAL/32). Chapter 1 is an introduction to the basic 
concepts of the assembler, central processing unit (CPU), and 
main memory. Also described are the instruction formats for 16- 
and 32-bit machines, as well as variations in the formats. 
Chapter 2 introduces assembly language symbolic representation 
and describes symbolic values. Chapter 3 defines the source 
program and contains a list of machine instructions, mnemonics, 
and a detailed description of assembler instructions. Common 
mode programming and common mode operations are explained in 
Chapter 4. 


CAL/32 operating instructions are listed in Appendix A. Appendix 

B contains CAL/32 error codese Appendix C describes the 

Perkin-Elmer 32-bit object code format and the Perkin-Elmer 

16-bit object code format. 

ROO of this manual can be used only with CAL/32 RO9 and OS/32 RO06 

and higher. The following features are incorporated: 

e Support of forward references in the operand of EQU, ORG, DS, 
and DO 

e Fase of use (via DEL and temp files) 

e Support of lowercase and underscore 

e Faster symbol table paging 

e Enhanced Copy 

e Externals with offsets 

e New start options 


The CAL/32 user should be familiar with the following 16- and 
32-bit manuals: 


PUBLICATION 
MANUAL NAME NUMBER 
Model 8/32 Processor User's Manual 29-428 
Model 7/32 Processor User's Manual C29-405 
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PUBLICATION 


MANUAL NAME NUMBER 
16-Pit Processor User's Manual C29-509 
Series Sixteen Processor User Manual C29-674 
Model 3240 Processor User's Manual C29-685 
Model 3220 Processor User's Manual C29-693 
OS/16 MT2 Programmer's Reference Manual 529-429 
OS/16 MT2 Operator's Manual S$ 29-430 
QOS/32 Operator Reference Manual 48-030 
OS/32 Supervisor Call (SVC) Reference Manual 48-038 
OS/32 Application Level Programmer Reference 
Manual 48-039 
32-Bit System User Documentation Summary 50-003 


For further information on the contents of all Perkin-Elmer 
32-bit manuals, see the 32-Bit Systems User Documentation 
Summarye 
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CHAPTER 1 
BASIC CONCEPTS 


12-1 INTRODUCTION 


Like all assemblers, Common Assembly Language/ 32 (CAL/32) 
Simplifies the direct control of the processor by providing the 
programmer with a way of representing actual machine operations 
in an easily understood symbolic form. Assemblers translate 
symbolic representations of machine instructions into binary form 
to be executed by the processor. CAL/32 also includes’ such 
features as relocation, segmentation, complex data definitions, 
and expression analysis. CAL/32 can run on any Perkin-Elmer 
processor and produce machine code for any Perkin-Elmer 
processor. 


Because assembly language programming is so close to actual 
machine operations, it is essential that the assembly language 
programmer have a good understanding of the system architecture. 
This chapter contains introductory architectural descriptions, 
and the programmer should read the appropriate processor 
reference manuals for more information. 


1.2 THE PROCESSOR 


All Perkin-Elmer processors are stored-program, multi~register, 
two-address machines. The major components are the central 
processing unit (CPU) and main memory. 


1-2-1 Central Processing Unit (CPU) 


To many, the CPU is something of a black box that performs 
arithmetic and logical operations in a precise and controlled 
waye To the assembly language programmer, the CPU is not 
completely opaque. Three of its cCcomponents--local memory or 
registers, the program status word  (PSW), and the I/O 
interface--are accessible through assembly language programming. 
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14.2.1-1 Local Memory (Registers) 


All Perkin-Elmer processors have some amount of local memory that 
can be used as temporary storage, accumulators, or indices. 
There are three types of local memory: 


e General purpose registers 
® Single precision floating point registers 


® Double precision floating point registers 


All processors have at least one set of 16 general purpose 
registers. In the 16-bit processors, each general purpose 
register holds 16 binary digits; in the 32-bit processors, 32 
binary digits. General purpose registers can be used for integer 
arithmetic, address arithmetic, logical operations, and character 
operations. 


Floating point registers are used only for floating point 
arithmetic operations. Processors with floating point registers 
have either eight single precision registers, or eight single 
precision registers and ight double precision registers. The 
Single precision registers hold 32 binary digits. The double 
precision registers hold 64 binary digits. 


Ts2~2 Program Status Word (PSW) 


The PSW defines the current state of the processor. It consists 
of three major parts: 


e Status descriptor 
e Condition code 


e Location counter 


Individual bits and bit fields within the status descriptor 
portion of the PSW define the current state of interrupts and 
various hardware features of the processor. By setting or 
resetting bits within the status descriptor, the programmer can 
enable or disable such interrupts as I/O, arithmetic fault, and 
machine malfunction. On those processors with multiple sets of 
general purpose registers, a field in the status descriptor 
defines which set is currently in use. Programmers writing user 
level programs, as Opposed to operating system or stand-alone 
programs, cannot directly access the status descriptor. In this 
case, the operating system maintains control of interrupts and 
registers. 
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The condition code provides a means of controlling program flow, 
based on the results of instruction execution. As certain 
instructions are executed, the value in the condition code 
changes to indicate the nature of the result. For example, if an 
Operation produces a zero result, the condition code may be 
changed to a zero value. With branch instructions, the 
programmer can test the value in the condition code and branch or 
not, depending on that value. Not all instruction executions 
affect the condition ccde. See the appropriate processor 
reference manual for more details. 


The location counter controls the order of instruction execution. 
Normally, the processor executes instructions sequentially and 
uses the location counter to keep track of where the instructions 
are in main memory, then fetches the instruction from the memory 
location specified by the address contained in the location 


counter. It executes that instruction, increments the location 
counter by the length of the instruction, and fetches the next 
instruction.e Branch instructions, when executed, change the 


contents of the location counter and thereby affect the branch. 


In 32-bit machines, the PSW contains 64 binary digits, the last 
24 of which are reserved for the location counter. In 16-bit 
machines, the PSW contains 32 bits; the last 16 are reserved for 
the location counter. 


1-2-3 I/0 Interface 


The execution of certain machine instructions allows the 
programmer tc control external devices and to cause the transfer 
of data between external devices and main memory or registers. 
The actual programming of I/0 operations is very much hardware 
dependant, both in the processor and the peripherals. I/0 
instructions are restricted to operating systems and stand-alone 
programs. User programs can communicate with I/O devices through 
facilities provided by the operating system. 


Te2e3e1 Main Memory 


To the assembly language programmer, main memory appears aS a 


block of contiguous storage locations. The smallest unit of 
memory the programmer can reference is the byte (eight bits). 
The programmer can also reference halfwords (two bytes), 


fullwords (four bytes), and dotble words (eight bytes). Each 
byte in memory is referenced by a unique address. Memory 
addresses start with zero and are incremented by one for each 


succeeding byte. Memory addresses in the 32-bit processors 
always consist of 24 bits. In the 16-bit processors, memory 
addresses consist of 16 bits. When accessing bytes, any memory 
address within the limits of the particular hardware 
configuration is considered valid. Halfwords must be referenced 
with halfword addresses. Fullwords must be referenced with 
addresses that are multirles of four. Double words must be 


referenced with addresses that are multiples of eight. 
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1.2.4 Software Relocation 


Programs written in CAL/32 can be absolute or relocatable. An 
absolute program is one whose origin (starting location) is 
specified at assembly time as a fixed halfword location in 
MEMOLY. Subsequent addresses within the program, whether 
referencing instructions or data, are fixed at assembly time. 
For execution, absolute programs alwayS must be loaded into 
memory at the location specified as the origin. This type of 
programming is useful in stand-alone applications and _ some 
operating system situations. 


Relocatable programs can be loaded for execution into any 
halfword location in memory. The origin of a relocatable program 
is assumed to be relocatable zero. The CAL/32 output for this 
type of program specifies all addresses in the program as 
relative displacements frem the origin. At link time, the 
linkage editor resolves all addresses within the program by 
adding a relocation value (the actual memory address for the 
start of the program) to the relative addresses supplied by 
CAL/32. Relocation applies only to addresses within the program. 
Relocatable programs can contain absolute data. 


122-5 Hardware Relocation 


Some Perkin-Elmer processors and their operating systems support 
hardware relocation and segmentation. Programs prepared for 
these systems start out as relocatable. A linkage editor 
processes the relocatable output from CAL/32 to link in any 
needed subprograms. The output of this process is an absolute 
program that, because of the relocating hardware, can be loaded 
at any memory address that is a multiple of 256 for memory access 
controller (MAC) machines, cr 2048 for memory address translator 


(MAT) machines. At run time, the relocating hardware adds the 
reguired relocation value to all addresses supplied by the 
PLrOgQramMme This relocating hardware also provides for program 


segmentation, where the program is divided into pieces that can 
be loaded into noncontiguous blocks of memory. 


CAL/32 supports segmentation by allowing the programmer to divide 
the program into pure and impure segments. The pure segment of 
a program consists of machine instructions and constant data and 
cannot be modified at run time. (The operating system and the 
hardware prevent modification.) The impure segment consists of 


the data base which can be modified at run time. Programs 
prepared as pure and impure segments can be shared (executed 
concurrently) by several users. Only one copy of the pure 


segment resides in memory during execution while there is one 
copy of the impure segment for each user. 


1-3 . INSTRUCTION FORMATS (16-BIT) 


The 16-bit processors have four types of machine instructions: 
register-to-register, register and indexed storage, register and 
immediate, and short forme The following abbreviations 
illustrate the instruction formats: 


OP Operation 


R14 First operand register 
R2 Second operand register 
N A U-bit immediate value 
X2 Second operand index register 
A2 second operand direct address 
2 Second operand immediate value 


Most instructions require two operands, the first of which is 
contained in a register. The result usually replaces’ the 
contents of the first operand register. Exceptions to these 
rules are noted in section 1.5. 


1.3.1 Register-to-Register (RR) Instructions 


Register-to-register instructions cause operations to take place 
hetween operands contained in registers. Register-to-register 
instructions are 16 bits long, as shown in Figure 1-1. 


Figure 1-1 RR Format (16-Bit) 


The first eight bits of the instruction define the operation. 
The next four bits identify the first operand register. The 
final four bits identify the second operand register. In most 
register-to-register instructions, the specified operation takes 
place between the contents of the first operand register and the 
contents of the second operand register. The result of the 
operation replaces the contents of the first operand register. 
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123-2 Register and Indexed Storage (RX) Instructions 


Register and indexed storage instructions cause ah operation to 
take place between a first cperand, contained ina register, and 
a second operand, located in main memory. These instructions 
require 32 bits, as shown in Figure 1-2. 


Figure 1-2 RX Format (16-Bit) 


The first eight bits define the operation. The next four bits 
identify the first operand register, and the next four bits 
identify an optional index register. The remaining 16 bits 
specify an address in main memory. The operation takes place 
between the contents of the first operand register and the 
contents of the memory location specified. The actual address of 
the second operand is determined by adding the contents of the 
index register to the contents of the address field. If the 
index field of the instruction contains zero, no indexing takes 
place. In most cases, the result of the operation replaces the 
contents of the first operand register. 


1.3.3 Register and Immediate (RI) Instructions 
These instructions cause cperations to take place between the 
contents) of a register and the contents of an immediate field 


imbedded in the instructicn itself. They are 32 bits long, and 
are shown in Figure 1-3. 


Figure 1-3 RI Format (16-Bit) 
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The first eight bits specify the operation. The next four bits 
identify the first operand register. The next four bits identify 
an optional index register. The final 16 bits are the immediate 
value. The first operand is the contents of the first operand 


register. The second operand is obtained by adding the contents 
of the index register to the contents of the immediate field. If 
the index field contains zero, no addition takes place. The 


result of the operation usually replaces the contents of the 
first operand register. 


1-3-4 Short Form (SF) Instructions 


These instructions are variations on the register and immediate 
instructions in which the second operand is small enough to be 
expressed in four bits. Short form instructions require 16 bits, 
as shown in Figure 1-4. 


Figure 1-4 SF Format (16-Bit) 


The first eight bits indicate the operation. The next four bits 
identify the first operand register. The next four bits contain 
the immediate value. Operations take place between the contents 
of the first operand register. The result of the operation 
usually replaces the contents of the first operand register. 


74-4 INSTRUCTION FORMATS (32-BIT) 


The 32-bit processors recognize seven different types of 
instructions. These are: register-to-register, three variations 
on register and indexed storage, two variations on register and 
immediate, and short forme. The following abbreviations are used 
to illustrate instruction fcrmats: 


OP Cperation 

R1 First operand register 

R2 Second operand register 

N A 44-bit immediate value 

X2 Second operand single index register 
D2 Second operand displacement 

FX2 Second operand first index register 
SX2 Second operand second index register 
A2 Second operand direct address 

I2 Second operand immediate value 
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Most instructions require two operands, of which the first is the 
contents of a register. The result of the operation usually 
replaces the contents of the first operand register. Exceptions 
to these rules are noted in Section 1.5. 


1-4.1 Register-to-Register (RR) Instructions 


The format and function of these instructions are the same as for 
the 16-bit processors. They cause operations to take place 
between operands contained in registers, and they require 16 
bits. These instructions are shown in Figure 1-5. 


Figure 1-S RR Format (32-Bit) 


The first eight bits specify the operation. The next four bits 
identify the first operand register, and the last four bits 
identify the second operand registere The processor performs the 
indicated operation between the contents of the first operand 
register and the contents of the second operand register. In 
most RR instructions, the result replaces the contents of the 
first cperand register. 


12422 Register and Indexed Storage One (RX1) Instructions 
These instructions define an operation between the contents of a 


register and the contents of a main memory location. They 
require 32 bits, as shown in Figure 1-6. 


Figure 1-6 RX1 Format (32-Bit) 
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The first eight bits define the operation. The next four bits 
identify the first operand register, and the next four bits 
identify the index registere The next two bits, bits 16 and 17, 
must be zeros. The next 14 bits constitute a direct program 
address ina range from 0 to 16383. 


The address of the second operand is obtained by adding the 
contents of the index register to the contents of the 14-bit 
address field. If the index register field contains zero, this 
addition does not take place, and the contents of the address 
field are used as the address. The operation takes place between 
the contents of the first orerand register and the contents of 
the specified memory location. The result usually replaces the 
contents of the first operand register. 


1.4.3 Register and Indexed Storage Two (RX2) Instructions 


These instructions define operations between the contents of a 
register and the contents of a location in main memory. RX2 
instructions are like the RX1 instructions; they require 32 bits. 
They differ from the RX1 instructions in the method of 
calculating the second operand address. See Figure 1-7. 


cdvewoasewoe ween secicuceeweceo ce ceeee ees Soocs Sete teecce epee eee cece ~S o--- 
| OP | R1 | X2 { 1 fA2 | 
wiiceeUete ce cbecee cee eect teehee eee eee eee oe Sees ee wae ee Se o--- 
Bits 

0) 7 8 11 12 15 16 17 31 


Figure 1-7 RX2 Format (32-Bit) 


The first eight bits define the operation. The next four bits 
identify the first operand register, and the next four bits 
identify the index register. The next bit, bit 16, must be a 
onee The remaining 15 bits are treated as a signed integer in 
two's complement notation. Bit 17 is the sign bit which, if one, 
indicates a negative quantity, and if zero, indicates a positive 
quantity. 


The address of the second orerand is obtained in two steps. 

V< The signed integer, with sign bit extended to produce a 
32-bit integer, is added to the contents) of the index 
register. 

2e This intermediate result is added to the value in the 


incremented location ccunter. The result is truncated to 24 
bits. 
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If the index register field is zero, the first addition does not 


take place. The indicated operation takes place between the 
contents of the first operand register and the contents of the 
specified memory locaticn. The result usually replaces the 


contents of the first operand register. 


1-4.4 Register and Indexed Storage Three (RX3) Instructions 


These instructions are analogous to the RX instructions in the 
16-bit processorse They call for operations between the contents 
of a register and the contents of an indexed memory location and 
require 48 bits. See Figure 1-8. 


Bits: 
0 


Figure 1-8 RX3 Format (32-Bit) 


The first eight bits specify the operation. The next four bits 
identify the first operand register, and the next four bits 
identify the first index register. Bit 16 must be zero. Bit 17 
must be one. Bits 18 and 19 must be zero. The next four bits 
identify the second index registere The next 24 bits contain a 
direct memory address. 


The address of the second operand is obtained by adding the 
contents of the first index register to the contents of the 
second index registere This intermediate result is then added to 
the contents of the direct address field, and the final result is 
truncated to 24 bits. 


If either of the index register fields contains zero, that level 
of indexing does not take place. If both are zero, no indexing 
takes place. In most RX3 instructions, the operation takes place 
between the contents of the first operand register and the 
contents of the specified memory location. The result usually 
replaces the contents of the first operand register. 


41-4.5 Register and Immediate One (RI1) Instructions 


These instructions are similar to the RI instructions in the 
16-bit processors. They specify operations that take place 
between the contents of a register and the contents of a field 
that is part of the instruction. They require 32 bits, as shown 
in Figure 1-9. 


1-10 48-050 FOO ROO 


Figure 1-9 RI1 Format (32-Bit) 


The first eight bits indicate the operation. The next four bits 
identify the first operand register, and the next four bits 
identify an index register. The second operand is obtained by 
extending the contents of the immediate field to 32 bits, by 
propagating the sign bit, and then adding this quantity to the 
contents of the index register. If the index register field is 
zero, no addition takes place, and the extended immediate value 
is the second operand. The operation takes place between the 
contents of the first operand register and the immediate value. 
The result usually replaces the contents of the first operand 
register. 


1-4.6 Register and Immediate Two (RI2) Instructions 


These instructions are Similar to the RI1 instructions, except 
that the field contains a 32-bit value, and the instruction 
itself requires 48 bits. See Figure 1-10. 


Figure 1-10 RI2 Format (32-Bit) 


The first eight bits define the operation. The next four bits 
identify the first operand register. The next four bits identify 
the index register. The second operand is obtained by adding the 
contents of the index register to the contents of the immediate 
field. If the index register field is zero, no addition takes 
place, and the immediate value is the second operand. The 
operation takes place between the contents of the first operand 
register and the immediate value. The result usually replaces 
the contents of the first orerand register. 
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1-427 Short Form (SF) Instructions 


Short form instructions are Similar to the SF instructions in the 
16-bit processors. They specify operations between the contents 
of a register and the contents of an immediate field, whose value 
is small enough to be expressed in four bits. These instructions 
require 16 bits, as shown in Figure 1-11. 


Figure 1-11 SF Format (32-Bit) 


The first eight bits define the operation. The next four bits 
identify the first operand register. The next four bits are the 
immediate field. The operation then takes place between this 
value and the contents of the first operand register. The result 
usually replaces the contents of the first operand register. 


1.4.8 Register and Indexed Storage/Register and Indexed 
Storage (RXRX) Instructions 


Register and indexed storage/register and indexed storage (RXRX) 
instructions resemble a fair of adjacent RX instructions, but 
represent one cohesive string-processing instruction. An RXRX 
instruction is comprised of two instruction members. Each member 
can be any one of the RX1, RX2, or RX3 machine formats, 
independent of the other member's formate For example, the first 
instruction member might be of the RX1 format, and the second 
instruction member might be of the RX3 format, yielding a 10-byte 
RXRX instruction. Thus, an RXRX instruction length might range 
from 8, 10, or 12 bytes. 


The first eight bits of the first instruction member, OP, specify 
the operation class. The particular RXRX operation is specified 
by the contents of the Operation-Modifier (OP-MOD) field in the 
first eight bits of the second instruction member. OP-MOD is 
actually generated by the assembler according to the specific 
RXRX operation mnemonic and the R1/L1 or R2/L2 fields programmed 
by the user in source code. Refer to Figure 1-12. 
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Figure 1-12 RXRX Format (32-Bit) 


The next four bits in the first instruction member, R1/L1, 
identify either R1, the string's length-specifying register, or 
L1, the string's actual length. The user specifies to the 
assembler whether the value in the R1/L1 field is a register or 
an immediate value. 


The R1/L1 field is assumed to be a register, unless an equal sign 
(=) precedes the L1 source expression. In machine format, the 
IL1 field is set when the =11 source field specifies an immediate 
value as length. The IL2 field in machine format is reset when 
the R1 field is used to specify a register that contains the 
string's length. When the length is an immediate value, its 
value may range from 0 through 15. When the length is in a 
register, the register may contain a length that ranges from 0 
through 224-1. A length of 0 indicates a null string. 


The remaining bits, bits 12? through 31 or 12 through 47, of the 
first instruction member, OPN1, contain the address/location of 
thé lowest addressable byte of a string or its storage location. 
The field, OPN1, is then similar to the indexed address portion 
of an RX1, RX2, or RX3 machine formate. See OPN2 below. 


The first eight bits of the second instruction member, OP-MOD, 
are an operation-modifier field containing OPN1's length 
indicator, IL1, in bit 03 OFPN2"s length indicator, IL2, in bit 1; 
a special circumstances bit, Cy, in bit 23; and in bits 3 through 
7, FUNC, the specific function code of the general operation 
Class, OP. As described above, IL1 and IL2 are determined by the 
assembler. The special circumstances bit, C, and function code, 
FUNC, are determined by the assembler from the 
operation-mnemonic. The C bit is used by some RXRX instructions 
to indicate that the result of the operation will be forced 
positive. 
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The next four bits, bits 8 through 11, of the second instruction 
member, R2/1L2, identify either R2, this string's 
length-specifying register; or L2, the string’'s actual length. 
Again, the user specifies in source format to the assembler 
whether the value in the R2/L2 field is a register or an 
immediate valve. The R2/L2 source format field is assumed to be 
a register, unless an equal Sign (=) precedes the L2 source 
expression. In machine format, IL2 is set when the =L2 field is 
used to specify an immediate value. IL2 is reset when R2 is used 
to specify a register. When the length is an immediate value, 
expressed as =L2, its value may range from 0 through 15. When 
the length is in a register, its value may range from 90 through 
224-1. A zero length indicates a null string. 


The remaining bits, bits 12 through 31 or 12 through 47, of the 
second instruction member, OPN2, contain the address/location of 
the lowest addressable byte of a second member's’ string. Both 
OPN1 and OPN2 are similar in format to the indexed address 
portion of an RX1, RX2, or RX3 machine format. The particular 
format of either OPN1 or OPN2 is selectively generated by the 
assembler, independently according to the user source program. 


In RX1 machine format, bits 16 and 17 are zero. Bits 12 through 
15 identify the index register, X2, the contents of which are 
added to the absolute 14-bit value, D, to formulate the string's 
address. 


In RX2 machine format, bit 16 is set. Bits 12 through 15 
identify the index register, X2, the contents of which are added 
to the 15-bit displacement value, D2, to formulate the string's 
address. 


In RX¥3 machine format, bits 16 through 19 are 0100 binary. Bits 
12 through 15 identify the first index register, FX2; and bits 20 
through 23 identify the second index register, SX2. The contents 
of both are added to the 24-bit address value, A, to formulate 
the string‘s address. 


NOTES 


1. When the first member's OPN1 
represents the string's address in 
RX2 format, the displacement value, 
D2, is relative to the end address of 
the first instruction member, not to 
the end of the full RXRX instruction. 


2 When the second member's OPN2 
represents the string's address in 
RX2 format, the displacement value is 
relative to the end of the _ second 
instruction member, which is also the 
end of the full RXRX instruction. 
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1-5 VARIATIONS ON INSTRUCTION FORMATS 


Not all instructions follow the above instruction formats. In 
some instructions the fields are redefined. Some instructions do 
not require two operands. Some instructions do not change the 
first operand, some instructions change the second operand, and 
some instructions change neither operand. 


1.561 Conditional Branch Instructions 


Conditional branch instructions use formats that resemble 
register-to-register, register and indexed storage, and short 
form instructions. However, the interpretation of the fields 
differs from the standard, as does the actual operation. [In all 
conditional branch instructions, the first operand identification 
is interpreted as a mask that is ANDed with the condition code. 
If the result of this test indicates that the branch is to be 
taken, then the second operand address is the location to which 
the processor must go to cbtain the next instruction. 


In the RR instructions, the second operand register contains the 


branch address. In the RX instructions, the branch address is 
obtained by one of the standard methods for obtaining second 
operand addresses. In the SF instructions, the immediate field 


is interpreted as a halfword displacement, either forward or 
backward, from the current location counter. The branch address 
is obtained by adding or subtracting this quantity from. the 
current location counter. 


1-5-2 Branch and Link Instructions 


These instructions facilitate branching to and returning from 
subroutines. They use formats similar to RR and RX where the 
first operand register is the link register. Before the branch 
is taken, the address of the next memory location following the 
branch instruction is placed in this register. In the RR 
instructions, the branch location is the contents of the second 
operand register. In the RX instruction, the branch address is 
obtained by one of the usual methods for obtaining second operand 
addresses. 


125-3 Other Variations 


Some instructions change the second operand rather than the 
first. Most notable among these are the store instructions and 
the instructions that add the contents of a register to the 
contents of a memory location. 


Test instructions and compare instructions change neither 
operand. The indicated operation takes place between the two 
operands, but neither is changed. The result of the operation is 
indicated by the condition code. 
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Certain other instructions, such as load PSW and simulate 
interrupt, do not always require a first operand. In addition, 
all of the I/0 instructions do not follow the general rules. For 
detailed information on how these and other anomalous 


instructions work, refer to the appropriate processor reference 
manual. 
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CHAPTER 2 
SYMBOLIC REPRESENTATION 


2e1 INTRODUCTION 


When writing assembly language programs, the programmer uses 
meaningful symbols to represent the binary language interpreted 
by both Common Assembly Language/32 (CAL/32) and the processor. 
Symbols consist of printable ASCII characters, either singly or 
in combination. CAL/32 reccgnizes the complete set of printable 
ASCII characters. However, depending on the context, there can 
be restrictions on the use of the complete set. See Chapter 3. 


2-2 SYMBOLS AND EXPRESSIONS 


Symbols represent addresses, register identifiers, absolute 
values, operation identifiers, and constants. Examples of 
symbols are: 


16 


Symbols can be combined to form expressions. The arithmetic 
operators: plus, minus, multiply, divide are represented in 
CAL/32 by the symbols: +, ~, *, ~/e They combine with other 
symbols to form arithmetic expressions. Examples of these 
arithmetic expressions are: 


A+B 
LAST-~FIRST*TWO 
h- 16 


Blanks and parentheses are not permitted within an expression. 
For example, the sequence: 


A-B* (Cc + OD) 
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would not be interpreted by CAL/32 as an expression. Depending 
on the context, CAL/32 might misinterpret the symbols, generate 
incorrect code, and fail to detect the error. Where CAL/32 can 
recognize the error, it generates an error message. 


The evaluation of expressions takes place from left to right with 
no rules of precedence. Thus, CAL/32 evaluates the expression: 


LAST-FIRST*TWO 


by subtracting the value of First from the value of Last, and 
multiplying this result by the value of Two. 


Logical expressions consist of symbols joined by the logical 
operators AND and inclusive OR. They are represented in CAL/32 
by the symbols & and !. Examples of logical expressions are: 


XEY!A 
CHARENULL 


Logical expressions are evaluated from left to right with no 
rules of precedence. Blanke and parentheses are not permitted in 
logical expressions. 


Mixed expressions are formed by combining logical and arithmetic 
operators. For example: 


A-B!TWO 


CAL/32 evaluates this expression by first subtracting the value 
of B from the value of A, and then ORing the result with the 
value of Two. Mixed expressions are like arithmetic and logical 
expressions in that blanks and parentheses are not allowed, and 
the method of evaluation is from left to right with no rules of 
precedence. 


Symbols represent either absolute or relocatable quantities. At 
assembly time, relocatable quantities have a value equal to their 
displacement from some fixed point within the program, usually 
but not necessarily, the origin or starting location. At load 
time, the relocatable quantity is replaced by an absolute 
quantity whose value is calculated by adding the relocation value 
to the relocatable quantity. Absolute quantities are known to 
the assembler at assembly time and are not changed at load time. 


The operations: multiply, divide, AND, and OR are permitted only 


between absolute data. The plus and minus operators can be used 
on mixed data. The results of such operations are: 
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CPERATION RESULT 


Absolute + Absolute Absolute 
Absolute - Absolute Absolute 
Relocatable + Relocatable Invalid 

Relocatable - Relocatable Absolute 


Relocatable + Absolute Relocatable 
Relocatable - Absolute Relocatable 
Absolute + Relocatable Relocatable 
Absolute - Relocatable Invalid 


2-3 SYMBOLS AND THEIR VALUES 


By definition, certain symbols used in CAL/32 programming have 
implicit values; that is, the value of the symbol is determined 
by the way in which it is expressed and used. Examples of this 
kind of symbol are the decimal, hexadecimal, and character 
Symbols used as operands in instructions. There are also global 
symbols in CAL/32. These symbols have preset values that cannot 
be redefined by the programmer. The programmer also can define 
the value of a symbol explicitly by using the equate statement. 
This section covers the use of implicit and global symbols. 
Chapter 3 covers the explicit use and definition of symbols. 


2e3-1 Implicit Symbols 


When used in the correct context, a string of decimal digits is 
automatically assigned the actual value of the number represented 
by the string. For example, the expression: 


A+14 


has a value that the assembler determines by adding the quantity 
14 to the value A, which must be defined by some other means. 


CAL/32 also recognizes the implicit value of special character 
strings the programmer uses to represent decimal, hexadecimal, 
and character values. These strings are made up of ae single 
letter that indicates the particular type, followed by a group of 
characters enclosed in apostrophes that represents the value. 
The code characters are; 


CODE CHARACTER TYPE 


Halfword decimal 
Fullword decimal 
Halfword hexadecimal 
Fullword hexadecimal 
Character 


Qs =< eo 
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Decimal numbers consist of an optional sign (+ or -) followed by 
decimal digits representing the actual value. Commas are not 
allowed in the representation. Halfword decimal values can be 
represented by from 1 tec 5 decimal digits, with a range from 
-32,768 to +32,767. Fullword values can be represented by from 
1 to 10 decimal digits, with a range from -2,147,483,648 to 
+2,147,483,647. CAL/32 converts these decimal numbers into two's 
complement binary integers. Examples of decimal symbols, with 
their internal representation expressed in hexadecimal notation 
are: 


SYMBCL VALUE 
H*125' 007D 
H*32765° TEFD 
H'+32765° TFED 

|stats Ho" he FEF 1 
F°423123" 0001 EOF3 
i Daas ae 0000 0001 


pta2* FREY FREE 


Hexadecimal symbols consist of the X or Y type code followed by 
a string of hexadecimal digits enclosed in apostrophes. Halfword 
symbols can use from one to four digits. Fullword symbols can 
use from one to eight digits. Leading zeros are not required, 
and the value is right justified. Examples of hexadecimal 
symbols are: 


SYMBOL VALUE 
X°F* OOOF 
X*DUE* OD4E 
Y¥*030° 0000 0030 
Y'A* 0000 OQOOA 
1207 0000 0000 


Character symbols consist of from one to four ASCII characters 
enclosed in apostrophes and preceded by the type code C. 
Characters are right justified, with zero fill. Depending on the 
context, either a halfword or a fullword results. Examples of 
Character symbols are: 


SYMBCL VALUE VALUE 
(HALFWORD) (FULLWORT) 
Cer OO2A 0000 OO2A 
Cr 2" 3432 0009 3132 
C* AB? 4142 C000 4142 
C*7234" 3334 a a I 3334 
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In the last example, where a halfword value was generated, only 


the rightmost two characters were used. Where the context 
dictates a halfword, and a longer string is used, a truncation 
error results. One final type of implicit assignment occurs in 


the use of symbols as statement identifiers. Where a symbol is 
used in the name field of a statement, it is automatically 
assigned a value equal to the value of the current location 
counter. This tyre of assignment is covered in Chapter 4. 


2e3e2 Global Symbols 


Six symbols recognized by CAL/32 have predetermined values. They 
ares: 


ADC 
LALC 
PURETOP 
IMPTOP 

-ABSTOP 
* 


The use of these symbols is somewhat restricted, and they cannot 
be redefined by the programmer. 


In programs written for 32-bit processors, the address’ length 
constant (ADC) always has a value of 4, the length of an address 
constant in bytes. (In 32-bit processors, addresses must be 
contained in fullwords, even though the actual address is only 24 
bits in length.) In programs for which CAL/32 is to generate 
16-bit code, ADC has the value of 2.2 ° In programs written for 
32-bit processors, the log (base 2) of the address length 
constant (LADC) always hag a value of 2. In programs for 16-bit 
processors, LADC always has a value of 1.2 Both of these symbols, 
ADC and LADC, are used most frequently in common mode 
programming. See Chapter 4. 


The symbols PURETOP, IMPTOP, and ABSTOP have values equal to: 


PURETOP The next available location in the pure segment 
IMPTOP The next available location in the impure segment 
ABSTOP The next available location in the absolute segment 


Because these values change during assembly, the symbols must be 
used carefully. They can he used as second operand identifiers 
in machine instructions and as operands in assembler instructions 
where they are treated as address values. They cannot be used in 
assembler instructions that control the location counter. 
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The asterisk symbol (*), used aS an operand rather than as an 
operator in an expression, always has a value equal to the value 
of the current location counter. Throughout the assembly 
process, CAL/32 maintains a location counter analogous to the 
hardware location counter contained in the central processing 
unit (CPU). Depending on the organization of the program, this 
location counter can contain any one of several values. For 
32-bit programs the location counter may point to the current 
location in the absolute segment, the pure segment, or the impure 
segment. For 16-bit assemblies, the location counter may point 
to the current absolute location or the current relocatable 
location. 
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CHAPTER 3 
THE SOURCE PROGRAM 


3-1 INTRODUCTION 


The source program consists of a set of assembly language 
statements that specify the operations to be performed by the 
processor, define the constants and storage areas used by the 
program, and control the assembly process to produce the desired 
output. Source statements for Common Assembly Language/ 32 
(CAL/32) are of two types: comment statements and instruction 
statements. Instruction statements are further divided into 
machine instructions and assembler instructions. Each statement 
consists of an e&O0O-character record, in which symbols and 
expressions identify the statement, and where necessary, indicate 
the operation and locate the operands. 


3.2 COMMENT STATEMENTS 


Comment statements can appear anywhere in the source programe 
They allow the programmer to include easy-to-read documentation 
in the source program listing. They produce no object code. The 
assembler does not process comment statements except to check for 
proper sequencing and scan for invalid characters. 


Comment statements must always start with an asterisk (*) in the 
first character position. Fositions 2 through 71 can contain any 
printable ASCII character, including lowercase alphabetic 
characters.e Blanks are ccnsidered to be "printable" characters. 
If a nonprintable character turns up in a comment statement, 
CAL/32 replaces it with a pound sign (#). Position 72 of a 
comment statement must contain a blank character. Positions 73 
through 80 can, at the programmer's option, be used for sequence 
identification. The sequence field can contain any printable 
ASCII character other than lowercase alphabetic characters. 
Where sequence checking is requested, each successive sequence 
identifier must be greater, in the ASCII collating sequence, than 
the previous identifier. Examples of comments are: 


POSITION 

1 72 =73 
* THIS IS A COMMENT 

* IT MAY APPEAR ANYWHERE IN THE PROGRAM 


* SUBROUTINE GETCHAR GET10000 
*MOVES A CHARACTER FRCM THE INPUT BUFFER GET10010 
*AND RETURNS IT IN GENERAL REGISTER THREE GET10020 
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3.3 INSTRUCTION STATEMENTS 


Instruction statements can be written in fixed format or in free 
format. For either format, there are five distinct fields in 
each statement. In fixed format, these fields are: 


CHARACTER POSITIONS DEFINITION 
1 through 8 Name field 
10 through 14 Operation field 
16 through n Operand field 
n+2 through 71 Comment field 
73 through 80 Sequence field 


Positions 9, 15, and 72 always must contain blank characters. 
The operand field and the comment field are variable in length, 
and the first blank character after position 16 serves as a 
delimiter between the operand field and the comment field. 
Because of the way the output listing is tabulated, the comment 
field cannot contain more than 37 characters. If more than 37 
characters appear, only the first 37 are printed on the output 
listing. 


CAL/32 does not require source statements to be written in fixed 
formate It accepts free format source, in which blank characters 
serve as delimiters. If, for example, the name field is not 
used, a blank character in the first position indicates that the 
next nonblank character is the start of the operation field. 
Similarly, if the operaticn field requires fewer than five 
characters, the first blank character following the operation 
code indicates that the next nonblank character is the first 
character cf the operand field. As in the fixed format 
statement, the first blank character following the operand field 
indicates the end of that field and the beginning of the comment 
field. There are three restrictions on the use of free format: 


1. Comment length is limited to 37 characters, including blanks. 
2. Position 72 must contain a blank character. 

36 The sequence field must start in position 73. 

The last restriction is because CAL/32 cannot distinquish between 
a blank character as part of a comment and a blank character 
intended to separate the comment from the sequence field. 

If there are no nonblank characters in positions 1 through 20, 
CAL/32 assumes that the statement is a comment and lists it as 


such, with a warning note. If more than 15 blanks separate the 
name field from the operation field, CAL/32 assumes that the 
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operation field is not present, Similarly, if more than 15 
blanks separate the operation field from the operand field, 
CAL/32 assumes that the operand field is not present. In both 
cases, CAL/32 generateS an error message. 


When writing CAL/32 instruction statements, the programmer uses 
Symbolic representation in the name field, the operation field, 


and the operand field. The following paragraphs describe the use 
of symbols and expressions in these fields. 


3.4 NAME FIELD 

Where a symbol appears in the name field, it represents the value 
of the current location counter for that particular instruction. 
This allows the programmer to refer to specific locations 
symbolically, without having to know the actual value of the 


location counter. The following five restrictions apply to the 
formation of names: . 


1<¢ The first character of a name must be an uppercase or 
lowercase alphabetic character or one of the special 
characters: 
- at sign (a) 
— dot Cad 


- dollar sign (S$) 


- underscore (_) 


NOTE 
Lowercase letters are internally 


converted to uppercase except in string 
constants. 


2s The remaining characters can be made up of any combination of 
valid first characters, plus the numeric characters 0 through 
9. 

Be The name must consist of from one to eight characters. 


ue The name must start in the first character position of the 
source record. 


5» Imbedded blanks are nct permitted. 
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Examples of valid names are: 


LABEL 
LOOP 1 
eSIN 
aGOTO 
SSGET5 


Examples of incorrect names are: 


1LOOP First character is numeric 
LOOPCOUNTER More than eight characters 
AB?C Questicn mark is illegal 


As a general rule, a given symbolic string can appear only once 
in the program where it defines a location. That is, the same 
symbol may not appear in the name field of more than one 
instruction. The exception to this is the equate instruction. 
This is covered in the section on assembler instructions. 


3-5 OPERATION FIELD 


The use of symbols in the operation field is severely restricted. 
Only previously defined symbols can appear in this field. The 
symbols that appear in the operation field are called mnemonics; 
they represent operations to be performed by the processor at run 
time, or operations to be performed by the assembler. CAL/ 32 
recognizes mnemonics that represent all machine operations for 
all Perkin-Elmer processors. It also recognizes a large set of 
assembler mnemonics that allows the programmer to control the 
asserbly process. 


Mnemonics can consist of no more than five characters. They are 
formed in the same way aS names and use the same character set. 
CAL/32 permits users to define mnemonics. This process is 
described in the section that deals with the equate instruction. 
Specific mnemonics that define machine operations and assembler 
Operations are described later in this chapter. Examples of 
operation mnemonics are: 


MNEMONIC TYPE MEANING 
AR Machine Add register 
S Machine Subtract 
CLE Machine Compare logical immediate 
ORG Assembler Set location counter 
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3-6 OPERAND FIELD 


CAL/32 permits the use of both symbols and expressions in the 
operand field of instructions. Symbols used in the operand field 
can be implicitly defined or can be explicitly defined. The 
rules for forming operands for assembler instructions vary from 
instruction to instruction, and each is described individually 
later in this chapter. 


Most machine instructions require two operands while some require 
only one. Where two operands are required, the first is 
separated from the second by a comma. Following are the general 
rules for forming operands for machine instructions. 


3.6.1 Register-to-Register Instructions 


Both the first and the second operand must be represented by 
Symbols or expressions with values between 0 and 15 inclusive. 
If the value is greater than 15 or less than 0, the assembler 
sets it to 0, and generates an error message. For example, if 
the symbols 1 and 2 appear in the operand field of the add 
register instruction: 


AR 1,2 


CAL/32 generates the machine code to add the contents of register 
2 to the contents of register 1 and store the result in register 
1. The use of 1 and 2 here is an example of how decimal numbers 
have an implicit value when used in the proper context. Another 
example: 


AR gee or 


shows how hexadecimal symbols can be used as register 
identifiers. This is an exception to the previously stated rule 
that hexadecimal symbols generate halfword or fullword values. 
Where used as register identifiers, decimal, hexadecimal, and 
character symbols cause the assembler to generate 44-bit values. 


Expressions can be used in identifying registers, as in: 
AR A+3B,C*A*=-X'UO! 


where CAL/32 evaluates the expressions and uses the results as 
the register identifiers. This is not a universally useful 
feature of the language, although it has some applications in 
common mode programming. 
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A more useful way to identify registers is to use explicitly 
defined symbols. Suppose the symbols SUM and INC are defined to 
have values of 1 and 2, respectively. Then the instruction: 


AR SUM,INC 
has the same effect as: 
AR 172 


yet the notation is more meaningful because registers 1 and 2? are 
identified as the SUM and INC registers. 


3-6-2 Register and Indexed Storage Instructions 


If the first operand is required, it must be a valid register 
identifier as described for register-to-register instructions. 
The second operand, separated from the first by a comma, can be: 


@® a symbol, 
@® an expression, or 


® a symbol or an expression followed by an index register 
identifier enclosed in parentheses. 


Where indexing is used, identification of the registers follows 
the same rules as those for specifying first or second operand 
registers. In double-indexed instructions, the first and second 
index identifiers are separated by a comma. An example of how 
register and indexed storage instructions are written is: 


2 1,A 


where the first operand is the contents of general register a fa 
and the second operand is the value at location A in memory. 
Another example: 


> SUM,TABLE(PTR) 


shows how single indexing is expressed. In this case, the first 
operand is the value contained in the register identified by the 
symbol SUM, and the second operand is the value at memory 
location table plus the contents of the index register PIR. 
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Another example: 
S SUM,LAST-FIRST( BASE, PTR) 


shows the use of double indexing along with the use of an 
expression in the operand field. A final example: 


S SUM,OCALTTR) 


illustrates where an address of a second operand is contained in 
the index register. Here, there must be a symbol in the address 
field even if it is equal to zero. 
3.6.3 Register and Immediate Instructions 
The first operand must be specified by a valid register 
identifier. The second operand can be: 
@ aosymbol, 
@® an expression, or 
@e aosymbol or an expression followed by an index register 

identifier enclosed in parentheses. 
Example: 

CLI STRNG,C‘ABCD* 

causes the character string ABCD, represented internally as _ the 
fullword character value 4142 4344, to be compared with the 


contents of the register identified by the symbol STRNG. In 
another example: 


CLi ADDR,LAST~FIRST(PTR) 


the expression LAST-FIRST is evaluated by CAL/32 at assembly 


time. At run time this value is added to the contents of the 
index register before the comparison takes place. In another 
examples 


CLI ADDR,Y¥‘'2000* (PTR) 


the fullword, hexadecimal quantity 0000 2000, is added to the 
contents of the index register. The result is then compared with 
the contents of the register identified by the symbol ADDR. 
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3.6.4 
(RXRX) Instructions 


The RXRX instructions 
of which is separated 
operand field can be: 


e a valid register identifier, 
defined absolute value in the 


e an equal sign (=) preceding a 
defined absolute value in the 


The second source operand field, 
comma, can bes: 


@e aosymbol or an expression 


® aosymbol or an expression, 


register 


or an expression, 
register 


e a symbol 
index 
Fair enclosed in parentheses 


The third source operand field, 
comma, can be: 


e a valid register identifier, 
defined absolute value in the 


@e® an equal sign (=) preceding a 
defined absolute value in the 


The fourth source operand field, 
comma, can be: 


e aosymbol cr an expression 


@® aeosymbol or an expression, 
register 


® a symbol or an expression, 
index register 
pair enclosed in parentheses 


Register and Indexed Storage/Register and Indexed Storage 


have four basic source operand fields, each 
from the other by a comma. The first 
symbol, or expression with a 
range 0 to 15 
Symbol or an expression with a 
range 0 to 15 
separated from the first by a 
optionally followed by an index 
identifier enclcsed in parentheses 
optionally followed by a pair of 
identifiers, separated by a comma, with the 
separated from the second by a 
Symbol, or expression with a 
range 0 to 15 
symbol or an expression with a 
range 0 to 15 
separated from the third by a 
optionally followed by an index 
identifier enclcsed in parentheses 
optionally followed by a pair of 
identifiers, separated by a comma, with the 
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Examples of how these instructions are written are: 
MOVE =LENGTH2,HERE,=LENGTH1, THERE 


which moves the string of length, LENGTH1, at location THERE to 
the location HERE up to the number of bytes indicated by LENGTH2. 
If LENGTH1 is less than LENGTH2, this instruction pads the extra 
bytes with the right-justified character in general register 
ZeLO. 


In the preceding example, the first operand field is the 
immediate value of symbol LENGTH2. The equal sign that specifies 
LENGTH2‘s value is an immediate value and not a register 
identifier. The second operand field is the storage address at 
location HERE. The third operand field is the immediate value of 
symbol LENGTH1 (its immediacy is again indicated by the equal 
sign). The fourth operand field is the string at location THERE. 


Another example is: 
MOVEP R7,PRINTOUT(LINE,COL2),R8,MESSAGE(CLASSX, ERRINDX) 


which moves the string of the length specified in general 
register R8, found at the memory location computed by summing the 
address value of MESSAGE with the contents of both index 
registers CLASSK and ERRINDX. The string is moved to a_e storage 
location whose address value is computed by summing the address 
value of PRINTOUT plus the contents of both index registers, LINE 
and CCL2. The number of bytes to be filled is the length 
specified in general register R7. If the length in R8 is less 
than that in R7, the MOVEP instruction, by definition, pads the 
extra bytes with the default character, a space. 


In the preceding example, the first operand field is the register 
identifier, R7:; the second operand field is the storage address 
at location PRINTCUT, as double indexed by the register 
identifiers, LINE and COL2; the third operand field is the 
register identifier, R8; and the fourth operand field is the 
string's location MESSAGE, as double indexed by the register 
identifiers, CLASSX and ERRINDX. 


Another example is: 
PMV =8,DECSUMS(SALESIC),5,TCTALSC(CORDERX) 


which packs and moves the unpacked decimal data digit string 
whose length is indicated in general register 5. Note that the 
5 means a general register because no equal sign precedes it. 
The unpacked decimal data digit string is found at the memory 
location computed by summing the address value of TOTALS with the 
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contents of the single index register identifier ORDERX. For 
details on how this conversion takes place, refer to the 
instruction definitions in the appropriate processor manuals. 
Generally, the unpacked decimal data is converted to packed 
decimal data up to the number of digits that may occupy the 
reserved byte length, indicated by the =8 expression. In this 
case, 8 bytes are reserved, providing storage for 15 decimal 
packed digits and a position for the sign-indicator. The PMV 
instruction, by definition, has various safeguards for illegal 
digit cases and overflow, and provides leading zeros as needed, 
when the number of positicns available for either the unpacked 
digits and the packed digits is of unequal length. The memory 
location to which the converted digit data is moved is computed 
by summing the address value of DECSUMS with the contents of the 
Single index register SALESID. 


In the preceding example, the first operand field is the 
immediate value =8. Note that the equal sign specifies that 8 is 
an immediate value and not a register identifier. The second 
operand field is the address location DECSUMS as singly indexed 
by the register identifier, SALESID. The third operand field is 
the register identifier 5; and the fourth operand field is the 
address location TOTALS, as indexed by the single index register 
identifier ORDERX. 


3.7 MACHINE INSTRUCTIONS 


Table 3-1 lists the mnemonics for all machine instructions. 
Where there is no entry in the format column, that instruction is 
not available for that particular line of processors. 


TABLE 3-1 SUMMARY OF MACHINE INSTRUCTIONS 
AND MNEMONICS 


| | 32-BIT | 16-BIT | 


| 

| INSTRUCTION | MNEMONIC { FORMAT | FORMAT | 
| a a a mR ea a a a a a a a nd | 
| Add | A | RX |} RX* | 
| Add DP Floating Point | AD | RX | RX { 
{| Add DP Floating Point | | | | 
{| Register | ADR } RR {| RR | 
| Add to Bottom of list | ABL | RX {| RX | 
| Add to Bottom of list | | | | 
{| Flagged | ABLF | | RX** | 
| | | | | 
} Add with Carry Halfwerd {| ACH | | RX | 
| Add with Carry Halfwerd | | | | 
{| Register | ACHR | | RR { 
| Acknowledge Interrupt {| ACK | | RX | 
} Acknowledge Interrupt | | | | 
{| Register | ACKR [ |} RR | 
| Add Floating Point | AE | RX | RX | 
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TABLE 3-1 SUMMARY OF MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 


| | | 32-BIT | 16-BIT 


{ INSTRUCTION | MNEMONIC {| FORMAT | FORMAT 
| HSS SHS SSeS Sear See SSeS SS SSS SSA SS RS RSS SSS SSS SSS SHS SESS sSES= 
| Add Floating Point | l | 

{ Register | AER | RR | RR 
| Add Halfword | AH | RX | RX 
| Add Halfword Immediate | AHI | RI1 | RI 
| Add Halfword to Memory | AHM | RX } RX 
| Add Halfword Register {| AHR } RR* | RR 
{ Acknowledge Interrupt | AI | | RX* 
j Add Immediate {| AI } RI2 {| RI* 
| Acknowledge Interrupt | | | 

| Register | AIR | | RR 
{| Add Immediate Short | AIS | SF | SF 
} Autoload {| AL | RX | RX 
| | | 

| Add to Memory { AM | RX | RX 
| Add Register { AR {| RR | RR 
| Add to: Top of List | ATL | RX | RX 
| Add to’ Top of List | | | 

| Flagged - | ATLF | } RX 
| Branch and Link | BAL | kX { RX 
{ Branch and Link | l | 

} Register { BALR { RR | RR 
| Branch to Control | { | 

| Storage {| BOCS | RX | RI 
J} Branch on Equal Status | | | 

| High Speed | BESHS | | RX** 
| | | | 

{ Branch on False Condition | | ] 

{| Backward Short | BFBS | SF | SF 
| | | 

| Branch on False Condition | BFC [| RX {| RX 
{ Branch on False Condition | | ] 

| Register | BECR {| RR } RR 
| Branch on False Condition | | | 

} Forward Short | BEES | SF | SF 
} Branch on Not Equal | l | 

| Status High Speed | BNSHS | | RAe* 
{| Branch on True Conditicn | { | 

{| Backward Short { BIBS | SF | SF 
| | | | 

{| Branch on True Conditicn | BIC } RX | RX 
{| Branch on True Condition | ] | 

| Register } BTCR | RR | RR 
| Branch on True Conditicn | { | 

{| Forward Short | BTFS | SF | SF 
| Branch on Index High | BXH { RX |} RX 
| Branch on Index Low or | | | 

{ Equal | RBXLE } RX j RX 
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TABLE 3-1 SUMMARY OF MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 


| | 32-BIT | 16-BIT | 


INSTRUCTION | MNEMONIC {| FORMAT | FORMAT | 
Compare | c | RX | RX* | 
Complement Bit | CRT | RX | | 
Compare DP Floating | | | | 

Point { CL | RX | RX | 
Compare DP Floating | | | | 
Point Register | CCR | RR { RR { 
Compare Floating Point | CE | RX {| RX | 
Compare Floating Point | | | { 
Register 1 CER { RR { RR | 
Compare Halfword | CH | RX | RX | 
Compare Halfword Immediate |{ CHI | RI1 | RI | 
Compare Halfword Register | CHR | RR* | RR { 
Change to Halfword Value {| CHVR | RR | { 
Compare Immediate j cI | RI2 |} RI* | 
Compare Logical GL } RX i RX* | 
Compare Logical Byte { CLB | RX |} RX | 
Compare Logical Halfword | CLH | RX | RX | 
Compare Logical Halfword | { | { 
Immediate | CLHI | RI1 | RI | 
| | | | 

Compare Logical Halfword | | | | 
Register | CLHR | RR* | RR | 
Compare Logical Immediate | CLI | RI1 i | 
Compare Logical Register | CLR | RR {| RR* | 
Compare Register | CR {| RR | RR* | 
Cyclic Redundancy Check | | | | 
Module 1? | CRC12 } RX i Rees j 
| | | 

Cyclic Redundancy Check | | | | 
Modulo 16 {| CRC16 | RX Ri | 
Decrement Counter High | | | | 
Speed | DCHS | { RX** | 
Divide | D |} RX | RX* | 
Divide DP Floating Point {| DD | RX | RX | 
Divide DP Floating Point | | | | 
Register | DDR | RR | RR | 
| | | | 

Divide Floating Point | DE {| RX | RX | 
Divide Floating Point | | | | 
Register | DER | RR | RR [ 
Divide Halfword } DH | RX | RX | 
Divide Halfword Register | DHR | RR* { RR | 
Divide Register | DR | RR { RR* | 


48-050 FOO ROO 


TABLE 3-1 SUMMARY OF MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 


| | 32-BIT | 16-BIT | 


| 
| INSTRUCTION | MNEMONIC | FORMAT | FORMAT | 
J HS SSSS erat se sass sass Ss seen sess esses sss see ssssssSesssss=2 | 
| Enter Control Storage j ECS | RI1 | SF | 
| Exchange Program Status | | { | 
{| Register | EPSR | RR | RR | 
| Exchange Byte Register | EXBR | RR } RR | 
| Exchange Halfword Register | EXHR {| RR | | 
| Float DP Floating Point | | | ] 
| Register |} FLDR {| RR | RR | 
| Float Register | FLR | RR {| RR { 
{| Fix DP Floating Point | | | | 
| Register | FXDR | RR {| RR | 
| Fix Register | FXR { RR | RR | 
{| Generate Inter-Process | | | | 
{ Interrupt | GIPI | | RR** | 
| Load | L | RX He al | 
| Load Address {| LA | RX a: 2 | 
| Load Byte {| LB | RX {| RX | 
| | | | 
{| Load Byte High Speed | LBHS | Roe | 
| Load Byte High Speed | | ] | 
} Indirect | | LBHST | YRS j 
| Load Byte Register | LBR {| RR } RR ] 
| | | | | 
| Load Complement Short ty Les | SF | SF | 
| Load DP Floating Point | LD ) RX | RX | 
| Load DP Floating Point | | | | 
| Register | LDR | RR } RR | 
| Load Floating Point | LE | RX { RX | 
| Load Floating Point | | | | 
|! Register | LER | RR | RR | 
| | | | | 
| Load Halfword | LH | RX { RX | 
| Load Halfword Immediate | LHI J} RI1 {| KI | 
| Load Halfword Logical {| LHL | RX {| RX* ] 
| Load Halfword Register | LHR } RR* } RR | 
{| Load Halfword and Set | LHS } RX | | 
| | | | | 
| Load Immediate | LI } RI2 ee | 
} Load Immediate Short { LIS | SF | SF 4 
{ Load Multiple {| LM | RX {| RX { 
| Load Multiple DP Floating | | { | 
{ Point | LMD {| RX } RX | 
} Load Multiple Floating | | | | 
{ Point | LME | RX | RX | 
| Load Program Status | LPS | | RX | 
|} Load Program Status | | | | 
~{ Register | LPSR | | RR | 
| Load PSW |} LESW | RX | RX | 
|} Load PSW Register | LPSWR | RR | | 
| Load Real Address |} LRA {| RX ] | 
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TABLE 3-1 SUMMARY OF MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 


-— oe ee oe a ow oe oe OF en om ee oe oe ee ow ew oe eo ee we aw ow ow © oe ag © ©w em oF oe oe © ow oe ow om ow oe om ow om ot gp oe em ww @ we we = 


S27 B1iT 


| 16-BIT | 


ee ee wee re ee wee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee we es ee ee ee ee ee we ee ee ee ee ee es ee ee es ee ee 
Se es ee ee ee ee eee ee eee ee ees oe a a OS on 8 em ere ane es om Om ome me ae a ee ee ee ee ee ae ce ee ee et as ay ee ee a Se ee 


Multiply 
Multiply DP Floating 
Point 
Multiply DP Floating 
Point Register 
Multiply Floating Point 
Multiply Floating Point 
Register 
Multiply Halfword 
Multiply Halfword Register 
Multiply Halfword Unsigned 
Multiply Halfword Unsigned 
Register 


Move and Process Byte 
String Register 
Multiply Register 

AND 

AND Halfword 

AND Halfword Immediate 


AND Immediate 

AND Halfword Register 
AND Register 

OR 

Output Command 


Output Command Register 
OR Halfvword 

OR Halfword Immediate 
CR Halfword to Memory 
OR Halfword Register 


OR Immediate 

OR Register 

Process Byte 

Process Byte Register 
Read Block 


Remove from Bottom of 
List 

Kemove from Bottom of 
List Flagged 

Read Block Register 
Reset Bit 

Read Data 


Se es OSE cm eee TE ees qe SOE Gere ER Ge cme qe comers Cm ey ce me Se eS ee ED cee ee SE eee ee epee SE gee ee eee ee SP ee ee ee se ee oe 


eee ee ee ee ee eee ee eee ee ee ee eee ees cere cee ee ee eee SS cee ee ee eee ee em ees ee ee oe eee eres ee ee cows rr eee ee ee gee Oe eee ee oe 


RR 


RX 


Z oo 
‘ bs oO 
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TABLE 3-1 SUMMARY OF MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 


| 32-BIT | 16-BIT 


| 

| INSTRUCTION {| MNEMONIC | FORMAT | FORMAT 
j Co — 
| Read DCS | RICS {| RR | RR 

| Read Data High Speed | RDHS | PoRS** 
} Read Data High Speed | | i 

| Register | RDRHS | | RR** 
| Read Data Register | ROR { RR { RR 

| Read Halfword | RH } RX {| RX 

| Read Halfword Register | RHR | RR | RR 

| | | | 

| Rotate Left Logical | RLL } RI1 |} RI 

| Rotate Left Logical | | | 

{| Short | RLLS | | SF** 
|} Read Process Data High | | | 

| Speed | REDHS | | RX** 
{ Replace PSW | RPSW | | RR** 
| | | | 

| Rotate Right Logical {| RRL |} RI1 } RI 

| Rotate Right Logical | | | 

} Short | RRLS | | SE** 
| Remove from Top of | | | 

| List {| RIL } RX | RX 

| Remove from Top of | | | 

| List Flagged | RTLF | | RX** 
| Subtract { Ss | RX {| RX* 
| | | | 

| Store Byte High Speed | | | 

{} Indirect | SBHSI | | -RI** 
| Set Bit | SBT |} RX | 

| Subtract with Carry | | ] 

| Halfword > SCH | {| RX 

{ Subtract with Carry | | | 

| Halfword Register {| SCHR | { RR 

! Simulate Channel Program | SCP | RX | 

| | | | 

| Subtract DP Floating | { | 

} Point {| SC } RX | RX 

{ Subtract DP Floating | | | 

| : Point Register | SDR { RR | RR 

{ Subtract Floating Point | cSt | RX { RX 

{| Subtract Floating Point | | | 

| Register | SER |} RR {| RR 

| Set Program Mask {| SETM | | RX 

| | | | 

| Set Program Mask Register | SETMR | |] RR 

| Subtract Halfword ) SH } RX | RX 

} Subtract Halfword Immediate]| SHI | RI1 {| KI 

{ Subtract Halfword from | | | 

| . Memory | SHM | bp Ra 


48-050 FOO ROO 


TABLE 3-1 SUMMARY OF MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 


Subtract Halfword Register 


Subtract Immediate 
Simulate Interrupt 


Subtract Immediate Short 


Shift Left Arithmetic 

Shift Left Halfword 
Arithmetic 

Shift Left Halfword 
Logical 

Shift Left Logical 

Shift Left Halfword 
Logical Short 

Shift Left Logical 
Short 

Store PSW 


Subtract Register 
Shift Right Arithmetic 
Shift Right Halfword 
Arithmetic 

Shift Right Halfword 
Logical 

Shift Right Logical 


Shift Right Halfword 
Logical Short 

Shift Right Logical 
Short 

Sense Status 

Sense Status Register 

Store 


Store Byte 

Store Byte High Speed 
Store Byte Register 

Store DP Floating 
Point 

Store Floating Point 


Store Halfword 

Store Multiple 

Store Multiple DP 
Floating Point 


Store Multiple Floating 


Point 
Supervisor Call 


32-BIT 


-— = ow ee em ee a ee aw aw a oF ow ew &@ ow @ © at @ © © oF oF © of ww @ @ @ @ @ we @ ow & © oo oF oe @ © we @& & 3 ow on oe oe 


| 16-BIT | 


RR** 


RR* 


ee) , 
rH 
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TABLE 3-1 SUMMARY OF MACHINE INSTRUCTIONS 
AND MNEMONICS (Continued) 


| | 32-BIT | 16-BIT 


| 

| INSTRUCTION | MNEMCNIC {| FORMAT { FORMAT 
{ a a a i a a a a a a a a ry 
| Test Bit | TBT | RX | 

| Test Halfword Immediate | THI |} RI1 | RI 

| Test Immediate | TI } RI2 i Ri* 
| Translate | TLATE |} RX L BLS 
| Test and Set } TS | RX | 

| Unchain {| UNC | {| RR** 
|} Write Block | WB {| RX { RX 

| Write Block Register | WER | RR | RR 

| Write Data | WD | RX | RX 

| Write DCS } WDCS {| RR | RR 

| | | | 

| Write Data Register {| WDR |} RR | RR 

} Write Data High Speed | WLHS | | RxX** 
| Write Data High Speed | | | 

| Register | WDRHS | | RR** 
} Write Halfword | WH | RX | RX 

|} Write Halfword Register | WHR | RR } RR 

| | | l 

| Write Processed Data | | | 

{| High Speed | WPEDHS | [ Ret 
} Exclusive OR } X | RX | RX* 
J Exclusive OR Halfword | XH |} RX |} RX 

{| Exclusive OR Halfword | ] | 

|} Immediate | XHI | RI1 } RI 

| Exclusive OR Halfword | | | 

| Register | XHR {| RR* | RR 

| | | | 

| Exclusive OR to Memory | XHM | | RxX** 
{ Exclusive OR Immediate {| XI } RI2 {| RI* 
| Exclusive OR Register | XR | RR | RR* 


* The indicated mnemcnic operation code is generated, 
and the listing is flagged with a question mark to 
indicate a vnotential error. 


** Model 50 instruction set 
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Table 3-2 lists the mnemonics for machine 


the Perkin-Elmer Model 3220 Processors. 
applicable. 


formats 


extended for 


The 16-bit format is not 


TABLE 3-2 SUMMARY OF MACHINE INSTRUCTIONS AND 
. MNEMONICS EXTENDED FOR THE PERKIN-ELMER 
3200 SERIES PROCESSORS 


Breakpoint 

Compare alphanumeric (RO=pad) 
Compare alphanumeric and 
default pad 

Load interruptible state 

Save interruptible state 


Load complement SP register 

Load complement DP register 

Load DP register from SP memory 
Load DP register frem SP register 
Load DP register freom general 
register pair 


Load process state 
Load SP register frem DP memory 
Load SP register frem DP register 
Load SF register frem general 
register 

Load general register pair 

from DP register 


Load general register 
from SP register 
Load packed decimal string 
as binary 
Load positive DP register 
Load positive SP register 
Load process segment table 
descriptor 


Load system segment table 
descriptor 

Move and pad (RO=pad) 

Move and pad default fad 
Move translated until 

Pack and move 

Pack and move absolute 

Read error logger 

Reset memory voltage failure 


ee ee nee me ee ree re ee ee ee ee ee ee re ee es wee ee ee ee ee ee ee ee ee we wee ee ee ee ee ee ae ee ee i ae 
ae rn pn ea SS ___. 


32-BIT | 


RX 

RXRX 
RXRX 
RXRX 
RXRX 
RXRX 

RX1 *** | 
RX1 ***] 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
RR | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
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TABLE 3-2 SUMMARY OF MACHINE INSTRUCTIONS AND 
MNEMONICS EXTENDED FOR THE PERKIN-ELMER 
3200 SERIES PROCESSORS (Continued) 


| | 32-BIT |{ 
| INSTRUCTIONS {} MNEMONIC | FORMAT | 
| -_—— oe eo eee eC So on os oo oe oe oe a eo oe on om ee oa ee ee | 
{ Store DP register in SP memory | STDE | RX { 
| Store binary as packed decimal | ] | 
{| string | STPB {| RX | 
| Store process state | STPS {| RX | 
{| Unpack and move | UMV } RXRX | 
| Unpack and move absolute } UMVA | RXRX | 
|} Store byte with no ECC | XSTB | RX | 


*** No register or other operands allowed in source 
format 


In addition to the set of mnemonics listed in Tables 3-1 and 3-2, 
CAL/32 recognizes a complete set of extended branch mnemonics. 
These instructions allow the programmer to call for conditional 
branch instructions without having to state explicitly the 
condition code maske Table 3-3 Lists these instructions. 


TABLE 3-3 EXTENDED BRANCH MNEMONICS 


| INSTRUCTION { MNEMONIC | 
| == 2-2-2225 2>-2S2S2 2222222225222 2 52252252 522°522=5=5°2°°522-22=-2=-=2=2-=—= == | 
| Branch on carry | BC | 
} Branch on carry register | BCR [ 
| Branch on carry short {| BCS | 
| | | 
} Branch on no carry } BNC | 
{| Branch on no carry register {| BNCR { 
|} Branch on no carry short | BNCS l 
| | | 
| Branch on equal | BE | 
| Branch on equal register | BER | 
} Branch on equal short {| BES | 
| | | 
} Branch on not equal {| BNE | 
| Branch on not equal register | BNER | 
{ Branch on not equal short | BNES | 
{| Branch on low |} BL | 
{| Branch on low register | BLR | 
{| Branch on low short {| BLS | 
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TABLE 3-3 EXTENDED BRANCH MNEMONICS 


(Continued) 
| INSTRUCTICN | MNEMONIC | 
| fn ee ee | 
| Branch on not low } BNL | 
|] Branch on not low register | BNLR | 
| Branch on not low short } BNLS { 
| | | 
| Branch on minus |} BM | 
| Branch on minus register | BMR { 
| Branch on minus short | BMS | 
| | | 
| Branch on not minus | BNM | 
{| Branch on not minus register | BNMR | 
{| Branch on not minus short | BNMS | 
| | | 
} Branch on plus { BP | 
{| Branch on plus register | BPR | 
| Branch on plus short } BPS | 
| | | 
| Branch on not plus | BNP | 
{| Branch on not plus register | BNPR | 
| Branch on not plus short | BNPS | 
| Branch on overflow | BO | 
{| Branch on overflcw register | BOR | 
| Branch on overflcw short |} BOS | 
| | | 
| Branch on no overflow {| BNO | 
{| Branch on no overflow register | BNOR { 
{| Branch on no overflow short | BNOS | 
| | | 
{ Branch on zero | BZ | 
{/ Branch on zero register | BZR | 
| Branch on zero short } BZS | 
| | | 
| Branch on not zero | BNZ | 
| Branch on not zero register {| BNZR { 
| Branch on not zero short |} BNZS | 
| | | 
| Franch unconditicnal } B | 
| Branch unconditional register | BR | 
| Branch unconditional short | BS | 
| | | 
| No operation | NOP | 
| No operation register { NOPR | 


extended 


is 
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branch instructions are essentialiy single operand 
instructions where the first operand mask value 
operation mnemonic. 


included 
The programmer supplies only the second 


operand or branch location. For short branches, the programmer 
does not have to specify the forward or backward direction. 
CAL/32 determines the direction of the branch and generates the 
appropriate machine code. For example: 


LOOP 1 L STRNG,TABLE(PTR ) LOAD STRING FROM TABLE 
CLR STRNG,INPUT COMPARE WITH INPUT 
BES END EQUIVALENT FOUND 
AIS PTR,4 NOT FOUND INCREMENT PTR 
BNZS LOOP1 GET NEXT STRING 
XR STRNG,STRNG NOT FOUND END OF TABLE 
END ST STRNG,RETURN RETURN VALUE 


In this program, CAL/32 determines the locations of LOOP1 and END 
and generates the required forward and backward branch 
instructions. 


Two more CAL/32 instructions that do not have direct machine 
equivalents are: 


INSTRUCTION MNEMONIC 


Branch on true condition short BTCS 
Branch on false conditicn short BFCS 


With these instructions, the programmer must specify the mask 
value and the branch location. CAL/32 determines the direction, 
forward or backward, and the appropriate machine operation is 
generated. 


3-8 ASSEMBLER INSTRUCTIONS 


Assembler instructions control the assembly process. Although 
they may resemble machine instructions in form, they do not 
generate any machine executable code. They are used to define 
symbols, reserve storage, generate data constants, and control 
the final output. 


3.8.1 Symbol Definition Instructions 


Symbol definition instructicns allow the programmer to assign 
values to symbols and set up communication paths between 
separately assembled programs. The latter operation facilitates 
the use of subroutines because they can be written and assembled 
separately from the main prcegram. At load time, a linking loader 
uses information supplied by CAL/32 to resolve addresses between 
Main programs and subroutines to set up the correct linkage. 
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3.8.1.1 Eqguate (EQU) Instruction 


This is one of the most commonly used assembler instructions. Tt 
assigns values to symbols and it has the form: 


NAME OPERATION OPERAND 


A symbolic name EQU An expression 


Examples of EQU instructicns are: 


LOOP EQU LOOP 1 
TOP FQU END-64 
DELTA EQU BOTTOM-TOP 
HERE EQU * 
START FQU X°10FE* 
SUM EQU 1 
PTR FQU 2 
EQU instructions can appear anywhere in the progran. CAL/32 


requires that each EQU instruction have a symbol in the name 
field and treats the absence of this symbol there as an error. 
The value assigned to a symbol by an EQU instruction is absolute 
or relocatable, depending on the type of expression in the 
operand field. If the cperand of an EQU statement contains a 
forward reference, CAL/32 will perform any additional passes 
required to define all symbols. CAL/32 does not reserve storage 
for symbols defined by an EQU instruction. Wherever it 
encounters the symbol in the program, CAL/32 replaces the symbol 
with the value defined in the EQU instruction. For example: 


STRNG EQU 1 

PTR EQU 2 

INPUT EQU 3 

LOOP 1 L STRNG,TABLEC( PTR) LOAD STRING FROM TABLE 
CER STRNG,INPUT COMPARE WITH INPUT 


‘In this case, CAL/32 generates the code to load register 1 with 
four bytes located at the address specified by TABLE, indexed by 
register 2. The next instruction causes CAL/32 to generate the 
code to compare the four bytes in register 1 with the contents of 


register 3. The use cf the EQU instruction here allows the 
programmer to assign meaningful names to the registers that hold 
the character strings, and index into the table. It also 
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provides a simple way to redefine the values assigned to these 
symbols. By changing the EQU instructions and reassembling, it 
is possible to change the values assigned to the symbols without 
doing extensive editing to change each individual statement where 
these registers are used. 


It is also possible, althcugh not recommended, to redefine a 
symbol within a program. Fer example: 


LOOP 1 EQU ~ 


LOOP1 EQU - 


When the symbol] LOOP7 is encountered in the first EQU 
instruction, CAL/32 assigns it the value of the current location 
counter. Subsequent references to LOOP1 receive this value. 
Following the second EQU instruction, the value of LOOP! is 
changed to the value of the new location counter. Because such 
redefinitions might not be intentional, CAL/32 issues a warning 
message wherever a symbol is redefined by an EQU instruction. 
(In the example, the programmer might have intended to write 
LOOP2 instead of LOOP1 in the second EQU instruction.) 


The user must guard against circular location counter dependency, 
as shown in the following example: 


A EQU m 
DS 1 
DS B-A 

B rQU bs 
END 


CAL/32 will flag an “MOO1 xxxTOP" error where xxx is PURE, IMP, 
or ABS, depending upon the current location counter. 


As stated earlier, CAL/32 permits the user to define operation 
Mnemonics within the programe To do this, the user defines the 
new mnemonic in an EQU instruction in which the new operation 
mnemonic is in the name field, and the operand field contains a 
hexadecimal constant of the form X‘nnxy'‘. Here, nn is the 
machine language operation code, and x and y are descriptors that 
tell CAL/32 how to handle the new mnemonic. The values of x and 
y inform CAL/32 of the instruction format. The values are 
defined as follows: 


x = O, y = 8 RR or SF format 
x = 0, Y = 2 RX or RI format 
Xx = 0, y = 4 R11 format 
x = 0, y= 1 KI2 format 
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To define extended branch mnemonics, x gets a value equal to the 
R1 field (mask) and y gets cne of the following values: 


y = 3 RX format 
y=ec RR format 
y = D SF format 


For example, in the instruction: 


BTC 15,ADDR 


the branch on true condition mnemonic and the mask field 15 can 
be combined into an extended branch instruction as follows: 


BTCF EQU X*42F3° 


in which BTCF is the new mnemonic; 42 is the machine code for the 
branch on true condition instruction; F is the mask value (15); 
and 3 specifies RX format. Once this new mnemonic is defined, 
the programmer can write: 


RTCF ADDR 


instead of: 


BTC 15,ADDR 


The new mnemonic definition remains in effect only for the 
program in which — it is defined. The new mnemonic must be 
different frem all other mnemonics recognized by CAL/32. 


There are three things to remember in using equate statements: 


ca The name field must always contain a valid symbol. 


2M The operand field must always contain a defined symbol or 
expression. 


ae The symbol that appears in the name field of an equate 


instruction must not appear in the name field of any other 
instruction, except another equate instruction. 


If any of these rules are violated, CAL/32 generates an 
appropriate error message. 
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3-8.1-2 External, Entry, Weak External, Weak Entry, and 


Data Entry (EXTRN, ENTRY, WXTRN, WNTRY, and DNTRY) 
Instructions 


These instructions are listed together since they perform 
corresponding functions to establish links between main programs 
and subroutines, and between programs with a common data base. 
These instruction forms are: 


NAME OPERATICN CPERAND 
Not used EXTRN Cne or more symbols 
(illegal) separated by commas 
Not used ENTRY Cne or more symbols 
(illegal) separated by commas 
Not used WXTRN One or more symbols 
(illegal) separated by commas 
Not used WNTRY Cne or more symbols 
(illegal) separated by commas 
Not used DNTRY Cne or more symbols 
(illegal) separated by commas 


The EXTRN instruction identifies symbols referenced by the 
program but defined outside the program. The ENTRY instruction 
identifies symbols defined within the program and referenced 
externally. (They can be referenced internally as well.) 


For example, consider two programs: one calculates the sine and 
cosine of an angle, the other uses the sine and cosine. The 
first is a general purpose program that could be used by many 
other programs. The ENTRY and EXTRN instructions make this 
possible without having to assemble the sine and cosine program 
every time it is needed. The sine and cosine program would 
contain an ENTRY instruction and entry points such as: 


ENTRY SIN,COS 


SIN EQU 7 


The symbols SIN and COS appear as operands in the ENTRY 
instruction and aS names in the EQU instructions. When CAL/32 
assembles this program, CAL/32 informs the linking loader that 
the locations identified by the names SIN and COS are entry 
points into the program. 
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The program that uses sine and cosine would contain an external 
statement and branch instructions such as: 


EXTRN SIN,CCS 


BAL LINK,SIN 


BAL LINK,COS 


* 


At assembly time, CAL/32 generates object data to inform the 
linkage editor that the symbols SIN and COS are externally 
defined. At link time, the linkage editor uses this information, 
along with the information generated by the entry instruction in 
the other program, to provide the necessary linkage. 


The WXTRN instruction is essentially equivalent to the EXTRN 
instruction. However WXTRN symbols are subject to the following 
exception processing by Link: 


® An error condition does not arise if the symbol is not 
resolved. 


e Object libraries are net searched in order to satisfy a weak 
external. 


e If a module containing an entry point referenced by a WXTRN 
symbol is included, then the entry point will be used to 
satisfy WXTIRN references to it in the normal fashion. 


The WNTRY instruction is essentially equivalent to the ENTRY 
instruction. However, WNTRY symbols are subject to the following 
exception processing by Link. 


e Weak entry points are not examined when searching an object 
library. Therefore, a program module containing a weak entry 
point is not included to satisfy an external reference. 


e If a program module containing a weak entry point is included 


from a module, the weak entry point will be used to satisfy 
external references in the normal fashion. 
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The DNTRY instruction is essentially equivalent to the ENTRY 
instruction. However, symbols nominated by DNTRY are resolved 
directly when building overlaid modules rather than resolved in 
an SVC instruction. This instruction identifies a symbol defined 
local to the program containing the DNTRY instruction. 


To help protect references to data in higher level nodes, Link 
automatically loads the entire path of overlays starting at the 
overlay containing data and ending with the overlay making the 
reference to a data entry point (DNTRY). A reference to a 
program section positioned in a higher level node, via _ the 
POSITION command, is treated the same way. A reference to data 
or a program section in the root will not cause a path of 
overlays to be loaded. 


If a DNTRY is referenced in a lower level node, an SVC 5 manual 

overlay load might be required to ensure that the overlay is in 

memory at the time of the reference. 

Restrictions on the use of external and entry instructions are: 

e The operand field of an external instruction must not contain 
an expression, such as SIN+4. 

e Expressions involving externally defined symbols must be of 
the forms: 


7 External symbol + absclute expression 


- External symbol - absolute expression 
BAL LINK,SIN+4 
is a legal use of an externally defined symbol. 
e Externally defined symbols cannot be used internally as 


instruction identifiers. 


e Any symbol identified as an entry must appear internally in 
the name of an instruction. 


e Symbols identified as entries cannot be redefined by multiple 
equate instructions. 

3.8.1.3 Include (INCLD) Instruction 

This information provides Link with a mechanism to guarantee the 


inclusion of object modules without other linkage references to 
ite It has the forms: 
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NAME OPERATION CPERAND 


Not used INCLD One or more 

(illegal) Symbols 
separated by 
commas 


The INCLD is used in the Same fashion as the EXTRN to linking 
references. However, this instruction is used to nominate 
program modules rather than external symbols. 


NOTE 
CAL/32 will generate the same object as 
in the past, provided none of the 
following instructions are used: 


external with offset, DCMD, DNTRY, WNTRY, 
WXTRN, or INCLD. The assembly of any of 
these instructicns will produce an object 
that TET will reject. Link is required 
to process modules containing this 
extended object. These instructions are 
only valid ina Target 32 assembly and 
have no effect on 16—biLt object 
generation. 


3.8.2 Data Definition Instructions 


These instructions allow the programmer to reserve areas of 
memory to be used at run time. Some of these instructions allow 
the programmer to specify values with which these areas can be 
initialized at load time. Other data definition instructions 
provide easy access to complex data structures. 


3-82-21 Define Storage (DS, DSH, DSF) Instruction 
This instruction causes CAL/32 to reserve a block of storage 


within the program without initializing the reserved locations to 
any value. It has the form: 


NAME OPERATION OPERAND 
A symbol DS An absolute 
(optional) expression 
A symbol DSH An absolute 
(optional) expression 
A symbol DSF An absolute 
(optional) expression 


The DS mnemonic causes CAL/32 to reserve the specified block of 
storage starting from the value of the current location counter. 
In the DSH form, CAL/32 first aligns the location counter on a 
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halfword boundary and then reserves the storage. In the DSF 
form, CAL/32 first aligns the location counter ona fullword 
boundarye Examples of the define storage instruction are: 


BUF 14 DS 100 
BUF2 DSH 125 
BUF3 DSF 16 


In the first example, CAL/32 reserves 100 bytes of storage Dy 
Simply adding 100 to the location counter. In the second 
example, CAL/32 reserves 125 halfwords (250 bytes) of storage. 
CAL/32 does this by aligning the location counter on a halfword 
boundary, if it is not already properly aligned, and then adding 
250 to it. In the third example, CAL/32 ensures that the 
location counter is aligned on a fullword boundary and then adds 
64 (the byte equivalent of 16 fullwords) to it. If the operand 
contains a forward reference, CAL/32 will perform any additional 
passes required to define all symbols. 


Define storage instructions are commonly used to reserve storage 


areas for transient data. Examples of this are I/O buffers and 
register save areaSe For example: 


ENTRY RSAVE 
EXTRN SIN,CCS 
LINK EQU 15 


RSAVE DSF 16 


BAL LINK,SIN 


shows how a main program might set up a register save area within 
itself. The code for the called program might look likes: 


ENTRY SIN,CCS 
EXTRN RSAVE 
RO EQU 0 


- SIN EQU * 
STM RO,RSAVE 
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where the subroutine stores the general registers in the 
externally defined area, RSAVE. When using define storage 
instructions remember that: 


e The DSH and DSF forms cf the instruction ensure halfword and 
fullword alignment. 


e The define storage instructions do not initialize memory to 
any particular value. 


e® cCniy one operand is allowed ina define storage instruction, 
and it must be a defined, absolute symbol or expression. 
3.8.22 Define Constant (DC, DCF) Instruction 


The define constant instruction allcws the programmer to reserve 
areas of memory and at the same time specify the initial value to 


be loaded into them. The define constant instruction has two 
forms: 
NAME OPFRATION OPFRAND 
A symbol DC One or more operands 
(optional) separated by commas 
A symbol DCF One or more operands 
(optional) separated by commas 


The DC mnemonic ensures that the first of the operands is aligned 
on a halfword boundary. The DCF mnemonic ensures that the first 
of the operands is aligned on a fullword boundary. Operands of 
different types can be used in the same define constant 
instruction. However, where alignment is a concern, the 
programmer must be careful in mixing operands of different types. 
Types of operands are described below. 


A single character code indicates the type of constant. This 
character code is not always required, and the exceptions are 
noted as they occure The assembler determines from the character 
code how it is to interpret the constant and translate it into 
the proper object format. Table 3-4 lists the character codes 
recognized by CAL/32, their meanings, and the types of constants 
generated. 
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TABLE 3-4 CONSTANT TYPES 


string integer of 7-bit ASCII 
encoded decimal digits 
(8-bits per digit) ina 
string of variable byte 


length. 


om oe ee we ee we ew oe ee © ww oe Oe em oe oo ae om & oe © oe ee ee om @ a am om oe am oe ae oe ce oe ow om ee am ae om am wee oe oe oe em ap em ee oe ow 


| COLE | MEANING | MACHINE FORMAT | 
| HS SHSS HS SS SS SS SHS SS SSS SS SSS SSS SSS SSS SSS SS SSS SSS SS SSSSS= | 
| xX | Hexadecimal | 16-bit binary [ 
| ¥ | Hexadecimal | 32-bit binary | 
| H | Integer |} 16-bit signed binary { 
{| F ] Integer | 32-bit signed binary | 
| A |} Address | 32-bit value of address | 
| 2 | Address | 16-bit value of address | 
| T | Address | One half of 16-bit address | 
| E |} Single precision | 32-bit floating point | 
| | floating point | format | 
| D | Double precision | 64-bit floating point | 
| |) floating point | format | 
ae {| Character {| An 8-bit code per | 
{ | | character (7-bit ASCII) | 
| | | | 
| P | Packed decimal | Fixed point sign-coded | 
| { string } integer of binary en- | 
| | | coded 4-bit decimal | 
| | |} digits ina string of | 
| | { variable byte length. | 
| | | | 
| U { Unpacked decimal | Fixed point sign-coded | 
| | | | 
| | | 
| | | | 
| | | | 
| | | | 


3.8.2.3 Hexadecimal Constants 


A hexadecimal constant consists of one or more hexadecimal 
digits, 92% through 9 and A through F, enclosed in apostrophes and 
preceded by the type code X or Y. Where the X type is used, 
CAL/32 reserves two bytes of storage and generates the loader 
information that will cause those two bytes to be initialized at 
load time with the binary representation of the hexadecimal 
numbere The Y type causes four bytes to be reserved and 
initialized. Examples of hexadecimal constants are: 


CONSTANT VALUE 
DC X¥*°1234° 1234 
DC Y'1234° 0000 1234 
DCE: X*°-20" 0020 
DCF Y'*OQO64* 0000 0064 
DC X'1234ABC* 4ABC 
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The first example shows a halfword hexadecimal constant which, 
because of the DC operation code, is aligned on a halfword 


boundarye The second example shows a fullword hexadecimal 
constant. In this case, fullword alignment is not guaranteed. 
The third example shows a halfword constant aligned on a fullword 
boundarye The fourth example shows how to force fullword 
alignment for a fullword constant. The last example shows what 
happens when too many digits are given. CAL/32 truncates' the 


constant to the least significant digits and generates an error 
mesSagee The maximum number of digits for an X type constant is 
four. The maximum number fcr a Y type constant is eight. 


NOTE 


Where fewer than the maximum number of 
digits are given, CAL/32 right justifies 
the value in the location and fills in 
the missing digits with zeros. 


Two special mnemonics facilitate the building of hexadecimal 
tables by eliminating the need to specify the X or Y type code. 
They have the form: 


NAME OPERATION OPERAND 
A symbol DCX One or more operands 
(optional) separated by commas 
Bh symbol DCY One or more operands 
(optional) separated by commas 


Operands for these instructions consist of from one to four 
hexadecimal digits for the [DCX instruction and from one to eight 
hexadecimal digits for the PCY instruction. Examples of these 
constants are: 


DCX 1,0,14AE,20,4040 
DCY 1,2FFFE,64,80900000 


The DCX instruction generates five halfword constants as follows: 


0001 
0000 
T4HAE 
0020 
O40 
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The DCY instruction generates four fullword constants as follows: 


0000 0001 
0002 FFFE 
0000 0064 
8000 0000 


Before generating the constants, CAL/32 ensures that they are 
properly aligned with halfword constants aligned on halfword 
boundaries and fullword ccnstants aligned on fullword boundaries. 


3.8.2.4 Integer Constants 


Integer constants can be either halfword or fullword. Halfword 
constants are expressed by the character code H followed by a 
string of from 1 to 5 decimal digits enclosed in apostrophes. 
Fullword constants are expressed by the character code F followed 
by a string of from 1 to 10 decimal digits enclosed in 
apostrophes. The range of halfword constants is from -32,768 to 
+32,767. The range of fullword constants is from -2,147,483,648 
to +2,147,483,647. The decimal strings used in these constants 
must not include commas or blanks. A Sign, + or -, can precede 
the string. 


The internal representation of integer constants is two's 
complement binary. In this notation, positive numbers and zero 
have their true binary form. For example, a halfwori integer 
with a value of 25 is represented internally (hexadecimal 
notation) as: 


00 


Negative numbers are expressed in accordance with the formula: 
Value = 2 - x 


where n is the number of bits used to express the value, and x is 
the absolute value of the number. For example, to represent 
minus 10 in a halfword constant: 


16 (1046) 
10 (Ade ) 
e 


alue = 100003 - Aqg = FFF646 


<x 5 


48-050 FOO RQO . 3-33 


Examples of integer 


CONSTANT 


DC H*32767° 
DC H* 32768" 


DC a 
DC Hie 2* 
DCP “ES2Z5* 


The H and F codes themselves do not guarantee correct 
fullword integer 
boundary, the programmer should use the DCF instruction. 


To ensure that a 


CAL/32 does not require that integer constants 


constants are: 


VALUE 


TEFF 
8000 
0000 0001 
FFFE 
0000 0019 


defined 


alignment. 
aligned ona fullword 


with 


the character codes and decimal strings enclosed in apostrophes. 


A simple decimal string can be used. 


CC 1 
DC bool 


The length of the 


integer constants 


For example: 


generated 


these 


instructions depends on the processor on which the program is to 


run. For 32-bit processors such instructions 


constants, such as: 


CONSTANT 
DC 1 
BCE =7 


FOr 16-bit proceSSOLs, these instructions 


constants, such as: 


CONSTANT 
DC 1 
LC mat; 


It is possible to force a fullword alignment 
decimal 
instruction affects only the alignment 


mnemonic with a 


integer constants; 


solely by the processor on which the program is 
when using these instructions 
it is not possible 


decimal strings, 


simple 


VALUE 


0000 0001 
PEEP -REEO 


VALUE 


0001 
FEES 


the length 


constant for a 32-bit processor. 


ive) 


~34 


with 


fullword 


halfword 


the DCF 
of a DCF 


of the 


constant is determined 
to be run. Thus, 


simple 


generate a halfword 
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3.8.2.5 Address Constants 


Address constants consist of a Single character type code 
followed by a symbol or an expression enclosed in parentheses. 
The three types of address constants are A, Z, and T. Type A 
constants generate fullword address constantS in programs 
intended to be run on 32-bit processors; they generate hnalfword 
address constants in programs intended to be run on 16-bit 
processorse Types Z and T address constants always generate 
halfword values. Examples of address constants are: 


DC A(LOOP+2) 

CDC A( TABLE) 

DC ACTOP-BOTTOM) 
DC ZCICVECTOR) 


DC TC ALPHATAB) 


For 32-bit processors, the first three examples cause CAL/32 to 
reserve a fullword of storage, initialized at load time to 
contain the value of the expression or symbol enclosed in 
parentheses. This value can be absolute or relocatable, 
depending on the nature of the expression. The address quantity 
is right justified in the least-sSignificant 24 bits of the 
fullword, and the most-significant 8 bits are forced to zero. 
However, it is possible to use the most-significant bits for some 
purpose. They might be used as flag bits as in the example: 


FARAM DS 4 

ADDR BC A (CPARAM+Y'A0009000') 
EXTRN SIN 

LINK EQU 15 

ADREG EQU 14 


otk RO, PARAM 
L ADREG,ALTCR 
PAL LINK,SIN 


At the time of the branch and link instruction, register 14 
contains the address of the location PARAM in the 
least-significant 24 bits. The most~significant 8 bits contain 
the value X'AQ*. The subroutine can use the address portion and 
the flag portion independently, as; 
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SIN EQU ba 


LE K4,OC(ADREG) GET PARAMETER 
TI ADREG,Y'AOQO00000° TEST FLAGS 


The Z type address constants generate halfword valuese They can 
be used in programs for 32-bit processors if the programmer is 
certain that the actual address cannot exceed 65,535, the maximum 
unsigned value that can be expressed in a halfword. 


The T type address constants are used as entries in translation 
tables. These instructions cause CAL/32 to reserve a halfword of 
storage initialized with one half of the actual address, right 
justitied. The most significant bit is zero. These constants 
are intended for use with the translation tables associated with 
the translate instruction and with the auto driver channel. 


Address constants can be written without the type code and 
parentheses, as in: 


TABLE DS 16 

BUFF 1 DS 64 

ADL1 DC TABLE ADDRESS OF TABLE 

ADD2 DC BUFF 1 ADDRESS OF BUFFER ONE 


Where this convention is used, the size of the generated constant 


depends on the processor for which the program is written. For 
32-bit assemblies, CAL/32 generates fullword constants. For 
16-bit assemblies, CAL/3Z generates halfword constants. The 


programmer can force halfwerd constants to be generated by using 
the mnemonic DCZ, as: 


CCZ TABLE,EUFF1 


which causes a series of halfword address constants to be 
generated. 
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3.8.2.6 Floating Point Constants 


The source form for floating point constants consists of a 
decimal number enclosed in apostrophes and preceded by the letter 
E for single precision, or the letter D for double precision. 
The decimal number consists of: 


® an optional plus sign or minus Sign, 


@e cne or more decimal digits that may include a decimal point, 
and 


® an optional F character followed by an optional plus sign or 
minus sign, followed by one or two decimal digits denoting a 
power of 10. 


Single precision floating pcint constants require a fullword of 
storage. Double precision floating point constants require a 
doubleword of storage. Internally, floating point constants are 
represented in excess 64 notation. In this kind of notation, 
each floating point number consists of a sign, an exponent, and 
a fraction. The first bit of the number is the sign bit. If 
this bit is a 1, the number is negative; if it is a 0, the number 
is positive. The next 7 bitsS represent the exponent, expressed 
in excess 64 notation. This field can contain any value between 
O and 127 inclusive. The remaining bits, 24 for single precision 
and 56 for double precision, represent the fraction with an 
implied radix point before the first bit. 


The true value of the floating point number is obtained by 
multiplying the fraction by 15 raised to the power indicated by 
the exponent field. In excess 64 notation, this power is 
determined by subtracting 64 from the value in the exvonent 
field. In this way, values equal tc or greater than 64 #=produce 
a OO or positive power. Raising 16 to this power and then 
Multiplying by the fraction produces values between .0625 and 7.5 
x 10. Exponent field values that are less than 64 produce a 
negative power and valves between ©-06249...2. and 5.4 x 10- . 
Floating point 0 is represented by a fullword or a double word of 
ZerCcSe 


Examples of floating point constants are: 


CONSTANT INTERNAL REPRESENTATION 
CC Bae 4110 0000 

DC E*0.0° 0000 9000 

DC E°7.2E74° 7F19 7817 

DC D°10.5' 41A8 0000 0000 0000 
DC D*'S.4E-79° 0010 01D1 33A9 49F6 
DC Dre 2k 75" 7JFEFE BOE3 AD97 8760 
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In the internal representation of floating point constants, the 
fractional part can consist of from 1 to 6 hexadecimal digits for 
Single precision, and up to 14 hexadecimal digits for double 
precision. If the decimal number exceeds this degree of 
accuracy, the magnitude of the number is preserved but the 
precision is lost. In performing the conversion from decimal to 
internal floating point, CAL/32 carries guard digits to ensure 6 
hexadecimal digit accuracy for single precision and 14 
hexadecimal digit accuracy for double precision. The programmer 
must ensure proper alignment. 


3.-8.2-7 Character Constants 


Character constants consist of the single letter code C followed 
by a string of ASCII characters enclesed in apostrophes. All 
characters are translated into 7-bit ASCII, in which the most 
Significant bit is always 0. Examples of character constants 
are: 


DC C*NAME® 
DC C*APOSTROPHE = ** ° 


The second example shows how an apostrophe is included in a 
character constant. Between enclosing apostrophes, a double 
apostrophe is treated as a single character. The maximum number 
of characters that can be defined in a single character constant 
is 64. If the number of characters in a constant is odd, CAL/32 
appends a blank character at the end to maintain halfword 
alignment. 


3.8.2.8 Decimal String Constants 


The source format for decimal string constants consists of a 
decimal number enclosed in apostrophes and preceded by the letter 
P for packed decimal string constants, or by the letter U for 
unpacked decimal string constants. The decimal number is an 
integer and consists of an optional plus sign or minus sign, 
followed by 1 to 31 decimal digits. 


The machine internal representation of the packed decimal string 
constant is a fixed-point, sign-coded integer, where each digit 
occupies 4 bits and each byte holds 2 digits. That is, each 
decimal digit, 0 through 9, is binary encoded in a 4-bit 
hexadecimal digit. As the number of decimal digits varies from 
1 to 31, the length in bytes of the decimal string varies from 1 
to 16 bytes. The last hexadecimal digit contains a 4-bit code 
for sign; a hexadecimal C for plus, or a hexadecimal D for minus. 
The integer representation is right-justified within the variable 
length string, so the least-significant digit of the decimal 
number occupies the hexadecimal digit just preceding the sign 
code. Each digit is thus consecutively packed, with the 
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most-~significant digit (zero or nonzero) in bit positions 0 
thrceugh 3 of the leftmost byte of the string. Refer to the 
examples that follow fer the differences in internal 
representation, when the packed decimal string constant is 
defined by either the define constant (DC) instruction or the 
define byte (DB) instruction. 


The machine internal representation of the unpacked decimal 
string constant is a fixed-point, sign-coded integer, where each 
zoned digit occupies a byte. That is, each decimal digit, 9 
through 9, is encoded in 7-bit ASCII with the leftmost bit 0; 
providing an 8-bit byte with the left hexadecimal digit 
containing a zone code of 3 and the right hexadecimal digit 
containing the binary encoded decimal digite As the number of 
decimal digits varies from 1 to 31, the length in bytes of the 
decimal string varies fre 1 to 31 #=bytes. The integer 
representation is right-justified within the variable length 
string. The rightmost byte contains the least significant digit 
in its rightmost hexadecimal digit and the sign code in its 
leftmost hexadecimal digit. The sign code is a 4-bit code, 
described above with a hexadecimal C for plus, and a hexadecimal 
D for minus. Fach digit is thus consecutively coded into bytes, 
with the most-Significant digit (zoned zero or zoned nonzero). 
Refer to the following examples for the differences in internal 
representation, when the unpacked decimal string constant is 
defined by either the DC instruction or the DB instruction. 


The address of the string is the address of the leftmost byte 
containing the most-significant digit (zero or nonzero). The 
address generated for either the packed decimal string constant 
or the unpacked decinal string constant is that associated with 
the -label of the source statements and the current location 
counter. Examples of the PDS constants are: 


INTERNAL 

REPRESENTATION 
SOURCE FORMAT (HEXADECI MAL) 
DB Pea 1C 
DB. P*+4+50" 050C 
DB P*~879' 879D 
DB P*+1234° 0123 4C 
DB* “Pte 7 2345°% 1234 5D 


DB P'1234567890123456789012345678901° 1234 5678 9012 3456 
7890 1234 5678 901C 


DC F*1* 001C 
LG’. Pit 0" 050C 
DG. pre B79" 879D 
be. “Piri gs" 0001 234C 
BC’. Pe r1Z2245. 001712 345C 


DC P*1234567890123456789012345678901' 1234 5678 9012 3456 
7890 1234 5678 901C 
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Note that as string-processing instructions are intended to 
operate at the lowest addressable level, on byte-addressable 
locations these constants are most efficiently generated by the 
DB instructions, described in the define byte instruction 
section. If the [PC instruction is used, an extra byte of leading 
zeros is generated, when the number of digits is a multiple of 4, 
or is an odd number of digits not divisible by 3. Examples of 
unpacked decimal string (zoned) constants are: 


INTERNAL 

REPRESENTATION 
SOURCE FORMAT (HEXADECIMAL) 
DB wU‘1° C1 
DB Ut+50° 35C0 
DB Ute 79" 3837 D9 
DB U'+1234° S132, 2304 
CB U*12345' 3132 3334 D5 


DB U*'1234567890123456789012345678901"* 3132 3334 3536 3738 
3930 3132 3334 3536 
3738 3930 3132 3334 
3536 3738 3930 C1 


BC. sue" 30C1 

EG. UFO" 35C90 

DC V*-879* 3038 37D9 

DC Y"'+1234" 3132 33C4 

CO U*'-12345' 3031 3233 34D5 


DC U*1234567890123456789012345678901' 3031 3233 3435 3637 
3839 3031 3233 3435 
3637 3839 3031 3233 
3435 3637 3839 30C1 


As string processing instructions require programmed length 


attributes, familiarization with the internal storage 
requirements for both packed decimal string and unpacked decimal 
string constants is advisable. In the previous examples, the 


relationship of number of digits to byte length is as follows: 


CONSTANT DEFINED BY BYTE LENGTH 
Packed DB (integer of n/2) + 1 
Packed we 2*(integer of n/4) + 2 
Unpacked DB n 

Unpacked cc n, for n even 


n+ 1, for n odd 


where n is the number of decimal digits in the source formats of 
the decimal constants. 
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3.8.3 Define Byte (DB) Instruction 


This instruction defines consecutive 8-bit bytes of data. It has 
the forms: 


NAME OPERATION OPERAND 
A symbol DB One or more operands 
(optional) separated by commas 


The symbol used in the name field of the DB instruction is 
assigned the value of the current location counter. There is no 
automatic alignment. The programmer must ensure proper alignment 
where the symbolic name of a DB instruction is used as an operand 
identifier in an instruction requiring its operand to be located 
on a halfword, fullword, cr double word boundary. 


The operand field can contain one or more operands, separated by 
commas. There can be an even or an odd number of operands. fhe 
operands can be any symbol cr expression value. For any operand, 
other than character or decimal string expressions, the least 
Significant eight bits of the operand value are used to generate 
one byte ot data. Examples of the DB instructions are: 


DB » ae eT a 

DB 128 

DB -1 

CB C*A' 

DB C*ABCDEFG' 


As shown in the examples, the operand of a DB instruction can be 
a signed integer. Ian this case, the integer can have any value 
between -128 and +127, inclusive. 


A special form of the DB instruction: 


DB e 


forces alignment of the location counter to a halfword boundary. 
a ae when this instruction is encountered, the location counter 
contains an odd value, one byte of zero value iS generated, and 
the location counter is made even. If the location counter is 
already even, this instruction has no etfect. 


48-050 FOO ROO 3-41 


3.8.4 Define List (DLIST) Instruction 

This instruction provides a simple means for defining circular 
lists used by the machine instructions: 

e Add to top of list 

e Add to bottom of list 

e Remove from top of list 


e Remove from bottom of list 


The define list instruction has the form: 


NAME OPERATION OPERANT 
A symbol DLIST An absolute 
(optional) expression 


The absolute expression in the operand field specifies the number 
of slots in the list. For 32-bit assemblies, CAL/32 reserves 
four halfwords of storage for list pointers, followed by the 
specified number of fullwords (slots). The first halfword list 
pointer is initialized with a value equal to the number of slots 
in the list. The remaining three pointers are initialized to 
ZeLOe For 16-bit assemblies, CAL/32 reserves four bytes of 
storage for list pointers, followed by the specified number of 
halfwords. The first byte pointer is initialized to a value 
equal to the number of slicts in the list. The remaining byte 
pointers are initialized to zero. An example of the DLIST 
instruction is: 


LIST1 DLIST 100 


In a 32-bit assembly, this has the same effect as: 


LIS? 1 LCF X¥°64"°,X°O",X'0"',X*9° 
DS 400 


The DLIST instruction forces alignment to a fullword boundary in 
32-bit assemblies. It forces alignment to a halfword boundary 
for 16-bit assemblies. 
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3.8.5 Define Command (DCMD) Instruction 


This instruction causes the string within the set of apostrophes 
to be passed directly to the object code. 


NAME OPERATICN CPERAND 
A symbol DCMD C ‘command 
(optional) string’ 


The operand of the DCMD instruction is subject to the same 
syntactic rules as any other character string. CAL/32 performs 
no syntax checking on the command string. 


CAL/32 will generate the same object as in the past, provided the 
DCMD instruction is not used. The assembly of this instruction 
Will produce an object that TET will reject. Link is required to 
process modules containing this extended object. The DCMD 
instruction is valid only ina Target 32 assembly and has_ no 
effect on the 16-bit object generation. 


3.8.6 Location Counter Instructions 


These instructions allow the programmer to select the current 
location counter and set its value. For 32-bit assemblies, 
CAL/32 maintains three location counters: pure, impure, and 
absolute. For 16-bit assemblies, it maintains two location 
counters: relocatable and absolute. At any given time, only one 
location counter can be in use. With these instructions, the 
programmer can control the program segmentation and relocation. 


3.8.6.1 Pure (PURE) Instruction 


This instruction causes all subsequent machine instructions to be 
assembled as part of the pure segment. It has the form: 


NAME OPERATION CPERAND 
A symbol PURE None 
(optional) (ignored ) 


The current location counter is saved, and the new location 
counter is set to point to the next halfword boundary beyond the 
most recently used location in the pure segment. If a PURE 
instruction occurs in a relocatable 16-bit program, it has no 
effecte If it occurs in an absolute 16-bit program, it causes a 
switch to the relocatable lccation counter. 
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3.8.6.2 Impure (IMPUR) Instruction 


This instruction causes all subsequent instructions to be 
assembled as part of the impure segment. It has the form: 


NAME OPERATION OPERAND 
A symbol IMPUR None 
(optional) (ignored) 


The current location counter is saved, and the new halfword 
boundary is set beyond the most recently used impure address. In 
16-bit assemblies, this instruction has no effect if the program 
is already in relocatable mcdee If it is in absolute mode, the 
location counter is switched to relocatable. 


NOTE 


Unless otherwise specified by the 
Erogrammer, impure mode is assumed. 


3.8.6.3 Origin (ORG) Instruction 


This instruction selects a location counter and sets it to a 
defined value. It has the form: 


NAME OPFRATION OPERAND 
A symbol ORG A symbol or 
(optional) expression 


The operand of the origin instruction determines which location 
counter is selected and the value it is given. If the value of 
the operand is pure, impure, ahsolute, or relocatable, the 
corresponding location counter is selected and set to the operand 
value. If the operand contains a forward reference, CAL/32 will 
perform any additional passes required to define all symbols. 


The user must guard against circular location counter dependency, 
as in the following example: 


ORG A 

LIS u,4 

A EQU B 

Lis 4,4 

B EDU i! 
eee 
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CAL/32 will flag an "MOO1 xxxTOP" error, where xxx is PURE, IMP, 
or ABS depending on the current location counter. 


NOTE 


If no ORG instruction appears at the 
beginning of a program, CAL/32 assumes it 
to be relocatable starting at relocatable 
ZeLrOe For 32-bit programs it also 
assumes the impure segment. 


3.8.6.4 Absolute (ABS) Instruction 


This instruction causes the location counter to be put in the 
absolute mode. Tt has the form: 


NAME OPERATION OPERAND 
A symbol ABS None 
(optional) (ignored) 


The current location counter is saved, and the new location 
counter is set to point to the next halfword boundary beyond the 
most recently used absolute location. If the absolute location 
counter was not previously used, it is set to zero. 


3.8.6.5 Align (ALIGN) Instruction 


This instruction aligns the current location counter to a power 
of 2. It has the forms: 


NAME OPFRATION CPERAND 
A symbol ALIGN A symbol or 
(optional) expression 


The value contained in the cperand field determines the type of 
alignment. Symbols used in the operand field must be previously 
defined. The value in the cperand field must be absolute and 
equal to either two, four, or eight. If the operand value is 
two, CAL/32 adjusts the Ilccation counter to ensure that it 
contains a halfword address. CAL/32 forces fullword alignment if 
the operand value is four, and double word alignment if the value 
is eight. If at the time of this instruction, the location 
counter is already properly aligned, CAL/32 does not change it. 
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If it is not properly aligned, CAL/32 increments it by the 
minimum amount necessary to force proper alignment. A symbol, if 
used in the name field, receives the value of the location 
counter after the alignment is performed. 


NOTE 


If the value of the operand is not 
absolute, or if it is not correctly 
defined, CAL/32 forces fullword 
alignment, and generates an error 
message. 


3.8.6.6 Conditional No Operation (CNOP) Instruction 


This instruction is similar to the ALIGN instruction in that it 
aligns the location counter to a power of 2. It has the form: 


NAME OPERATION OPERAND 
A symbol CNOP A symbol or 
(optional) expression 


The CNOP differs from the ALIGN instruction in that instead of 
merely incrementing the location counter, it actually inserts no 
operation instructions into the program stream. The value of the 
operand must he absolute and equal to two, four, or eight. 
Symbols used in the operand field must have been previously 
defined. If at the time this instruction is encountered, the 
location counter is on an odd boundary, CAL/32 increments it by 
one to make it even, inserts the required number of CNOP 
instructions to force alignment, and generates an error message. 
This instruction has no effect if the location counter is already 
properly aligned. A symbol, if used in the name field, receives 
the value of the location counter associated with the first CNOP 
instruction generated. 


3.8.7 Assembler Control Instructions 
These instructions allow the programmer to control the assembly 
process itself, identify the type of processor on which the 


program is to be run, halt the assembly operation temporarily, 
and request a limited amount of optimization. 
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3.-8.7-1 Target (TARGT) Instruction 


This instruction identifies the type of processor on which the 
program is to be rune It has the forms: 


NAME OPERATION OPERAND 
A symbol TARGT A symbol or 
(optional) expression 


The value of the operand expression must be either 16 or 32, 
absolute. Symbols used in the operand field must be previously 
defined. If the operand value is 16, CAL/32 generates object 
code for 16-bit processors. If the value is 32, it generates 
object code for 32-bit processors. If the value is anything 
else, CAL/32 generates a Warning message and generates code for 
the same type of processor cn which it is running. If there is 
no TARGT instruction in the program, CAL/32 assumes the target 
Machine to be the same as the machine on which the assembly is 
running.e 


NOTE 
The TARGT instruction must precede any 
PURE or IMPUR instructions or any 
instruction that generates machine code. 


3.8.7.2 End (END) Instruction 


The END instruction indicates the end of the source input. It 
has the form: 


NAME OPFRATION CPERAND 
A symbol END A symbol or 
(optional) expression (optional) 


Because of its function, this statement must be the last 
instruction in the source input file. The optional operand, if 


used, identifies the starting location of the program. For 
example: 

MAIN EQU * 

LAST END MAIN 
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The END instruction, with the operand MAIN, causes CAL/32 to 
output information identifying the location MAIN as the starting 
location of the program. The loader and the operating system use 
this information to ensure that the program starts at the 
reguested location. If there is no operand, the END instruction 
merely terminates the assembly process without outputting any 
loader information. The END instruction is required in all 
CAL/32 programs. 


3.8.7.3 Copy Library (CLIB) Instruction 
This instruction allows the user to specify or change library 
files from within a program. It has the form: 


CLIB vol:fname.ext 


Fach CLIB statement logically concatenates the new library file 
(operand of CLIB) to any existing library file. If the new 
library file cannot be assigned, CAL/32 will log an error message 
and pause. 


3.8-7-4 Copy (COPY) Instruction 


This instruction allows the programmer to insert source code from 
library files into the source code received from the regular 
source input file. It has the form: 


NAME CPERATICN CPERAND 
A symbol COPY A symbol[,vol:fname.ext | 
(optional) (required) 


CAL/32 assumes that the library file was assigned to lu 7 (see 
Appendix A). CAL/32 also assumes that the file is made up of 
80-character records. It searches through the logical file, 
looking only at the first 10 characters of each record until it 
finds a file label of the form: 


RECORD PCSITION CONTENTS 
1 and 2 ae 
3 through 10 A valid symbolic name of 


from 1 to 8 characters 


in which the symbolic name exactly matches the symbol in the 
operand field. If the search is unsuccessful, CAL/32 logs the 
message: 


CCFEY ERRCR: XXXXXXXX 
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in which xxxxxxxx is replaced by the name of the file being 
sought. This might happen in the case of incorrect file 
assignment. The operator can change the assignment and resume 
the assembly process from the location of the COPY instruction. 
The COPY instruction allows only one operand. The programmer 
must provide one COPY instruction for each file to be copied into 
the source stream. 


If the optional second operand is supplied, CAL/32 will assign 
and search only that physical file and ignore any files logically 
attached by CLIRB. If the file cannot be assigned, CAL/32 will 
log an error message and pause. 


The copy process terminates when an END statement is encountered 
in the file, or when a record with either /* or /& in the first 
two character positions is encountered. Where an END instruction 
is encountered in the copy file, it does not mean the end of the 
source file but only the end of the copy file. At this point, 
CAL/32 resumes reading from the source input file. COPY 
instructions may not appear in files which are themselves being 
included in a source program by means of a COPY instruction. 


3.8.7.5 File Copy (FCOPY) Instruction 
The assembler instruction FCOPY allows the user to copy an entire 
library file. It has the ferm: 


FCOPY vol: fname.ext 


When FCOPY is in effect, a /* starting in column 1 or an END in 
the op code field will be skipped, and copying will continue 
until an end of file is reached. If the file cannot be asSigned, 
CAL/32 will log an error message and pause. 


3.8.7-6 Pause (PAUSE) Instruction 


The PAUSE instruction allows the programmer to halt the assembly 
process. It has the form: 


NAME OPERATION OPERAND 
A symbol PAUSE None 
(optional) (ignored) 


The PAUSE instruction temrorarily halts the assembly process. 
When the assembler encounters a PAUSE instruction, the assembler 
requests the operating system under which it is running to 
suspend execution. The system notifies the operator. The 
operator can resume execution of the assembler at the instruction 
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immediately following the PAUSE instruction by using the 
operating system command CONTINUE. For example, the PAUSE 
instruction can be used by the operator to reassign a copy file, 
such ass: 


COPY REGEQUS COPY REGISTER EQUATES 
PAUSE 
COPY COMBLKS COPY COMMON BLOCKS 


38.727 Squeeze (SQUEZ) Instruction 


The SQUEZ instruction puts CAL/32 into a mode in which it 
performs a limited amount of space optimization. It has the 
form: 


NAME OPERATION OPERAND 
A symbol SQUEZ A symbol or 
(optional) expression (optional) 


When in optimization mode, CAL/32 makes multiple passes over the 
source input. During each pass, it attempts to reduce long 
instructions (48 and 32 bits) to shorter forms (32 and 16 bits). 
The value of the operand expressions sets the maximum number of 
passes. If CAL/32 can complete the optimization in fewer passes, 
it stops the optimization process and completes the assembly. 


The value otf the operand expression must be an absolute number 
between 1 and 99. Any symbols used in the expression must have 
been previously defined. If the operand value is 0, or if there 
is no operand, CAL/32 assumes a maximum of 9 passes. 


NOTE 


If there are user induced errors in the 
source stream (illegal mnemonics Or 
undefined symbols), CAL/32 terminates the 
squeeze operation and goes on to produce 


the final assembler output. Some 
instructions in this output may have been 
squeezed, depending on where in the 


process the errors were discovered. 


CAL/32 performs three types of space ontimizations: 


tT Changes RX3 instructions to RX2 or RX1 


2. Changes operation codes to allow the use of an equivalent, 
but shorter, instruction 


3. Eliminates unconditional branch instructions to the next 
halfword location 
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An example of the first type of optimization is the forward 
reference instruction. In this instruction, the operand is 
defined in the program at some point beyond the instruction to 
which it refers. 


Examples: 


A R1,VALUE 


VALUE DCF F425? 


When CAL/32 processes the ACD instruction, it cannot tell if the 
location of the second operand, identified by the symbol VALUE, 
is within the range of either an RX1 or RX2 instruction. It has 
to assume that an RX3 jdainstruction is necessarye By making 
additional passes over the Source input after all addresses have 
been resolved, CAL/32 has the needed information to determine if 
the reference to VALUE is within the range of either an RX1 or an 
RX2 instruction and make the substitution. 


An example of the second tyre of optimization is: 
LI k3,-1 
In the optimization mode, CAL/32 reduces this instruction to: 


LCS R3,1 


which reduces the length of the instruction from 48 bits to 16 
bits, without changing the effect. Depending on the processor, 
the substituted instruction might be faster or slower than the 
original instruction. 


NOTE 
CAL/32 changes an operation code only in 
the object outout.e The original 
instruction remains in the listing, 


flagged with an asterisk. 
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The third type of optimization does not occur in normal 
programming, but it does Sometimes appear in compiler generated 
CAL/32. For example: 


ST R1,SAVE 
B CONTINUE 
CONTINUE L R1,TEMP 


In this case, CAL/32 simply eliminates the unnecessary branch 
Lnstruction, although the branch instruction does appear in the 
assembly listing, flagged with an asterisk. 


More than one SQUEZ instruction can appear in the program. The 
first SQUEZ instruction sets the number of additional passes. 
Subsequent SQUEZ instructions put CAL/32 back into optimization 
mode after a NO SQUEZ instruction (described below) took it out 
of the optimization mode. Operands may appear in the subsequent 
SQUEZ instructions, but they are ignored. 


Because CAL/32 looks at only one instruction at a time, and 
because its global data is limited to the symbol table, squeezing 
might introduce errors inte the program. This is most likely to 
happen when data and instructions are mixed. 


Example: 


BTC 8, LOOP 1 


LOOP 1 EQU = 


BFC 0,LOOF2 


CS 26 

ALIGN 4 
CONST DC EU2Zo0" 
LOOP2 EQU = 
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If on one pass, CONST is already aligned on a fullword boundary, 
the branch to LOOP2 can be converted to a short format branch. 
A subsequent pass may allow the branch to LOOP1 to be shortened. 
When this happens, CONST is no longer on a fullword boundary, and 
CAL/32 adds two to the location counter to align it properly. 
This forces LOOP2 out of the range of a short branch instruction. 
CAL/32 will recover from this situation by changing the branch 
instruction back to its original format and marking it internally 
as unsqueezabkle. 


3.8.-7.-8 Squeeze Related (NOSQZ, ERSQZ, NORX3) Instructions 
There are three additional instructions that can be used to 


control squeezing and optimization of the source input file. 
They have the form: 


NAME OPERATION OPERAND 
A symbol NOSQZ Not used 
(optional) (ignored ) 
A symbol ERSQZ Not used 
(optional) (ignored ) 
A symbol NORX 3 Not used 
(optional) (ignored) 


The no squeeze instruction (NOSQZ) has the effect of turning off 
the optimization processes initiated by a previous SQUEZ 
instruction. Optimization can be restarted by a subsequent 
squeeze statement. NOSQZ overrides a squeeze start option. 


The error squeeze instruction, (ERSQZ) can be used with the SQUEZ 
instruction. It forces CAL/32 to continue Squeezing even after 
assembly errors are detected. 


The no RX3 instruction (NORX3) provides a simpler form of 
optimization during a nermal 72-pass assembly. Once this 
instruction is encountered, CAL/32 forces RX instructions to the 
RX1 or RX2 format. RX3 instruction formats are still generated 
if double indexing is specified, or if. the instruction references 
an element of a common bicck or an externally defined symbol. 
Thig instruction can be safely used in programs that are smaller 
than 16kb. It must not be used in segmented (pure and impure), 
programSe 
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3.8.-7.2-9 Sequence Checking (SQCHK, NOSEQ) Instructions 


The sequence checking instructions enable and disable the 
sequence checking of source. They have the form: 


NAME OPERATION OPERAND 
A symbol SQCHK Not used 
(optional) (ignored ) 
A symbol NOSEQ Not used 
(optional) (ignored ) 


The sequence check instruction (SQCHK) causes CAL/32 to compare 
each source statement Sequence number with the number of the 
preceding statement. Each successive number must be greater in 
the ASCII collating sequence than the preceding one.e. CAL/32'S 
initial sequence value is equal to eight spaces, so that numbers 
can be right justified in the field without leading zeros. Ifa 
source statement contains a value equal to or iess than the 
preceding statement, CAL/32 generates an error messagee The 
sequence fields of statements included in the program by a COPY 
instruction are not checked. 


The no sequence check instruction (NOSEQ) disables the sequence 
checking process. The sequence field of this instruction is 
checked, if sequence checking was in effect at the time. The 
default mode of CAL/32 is NOSEQ. 


3-8e7-10 Scratch (SCRAT) Instruction 


The scratch instruction causes CAL/32 to copy the source input 
file to a scratch device during pass one. It has the form: 


NAME OPERATION OPERAND 
A symbol SCRAT Not used 
(optional) (ignored) 


Subsequent passes over the source input file are read from the 
scratch device. Since no statement preceding the SCRAT 
instruction can be copied, the SCRAT instruction should be the 
first statement in the prcgram. 


3-8-7211 Pass Pause (PPAUS) Instruction 


This instruction causes CAL/32 to issue a pause request to the 
operating system at the end of each pass. It has the form: 


NAME OPERATION OPERAND 
A symbol PPAUS Not used 
(ignored) (ignored) 
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The purpose of the PPAUS instruction is to allow the operator 


reset the 
This is useful in sSituaticns 
and the source input file is 


to 


source input file to the beginning for the next pass. 


where ne scratch file is 
not rewindable. 


available, 


NOTE 


Where neither the SCRAT instruction nor 
the PPAUS instruction is used, CAL/32 
issues a rewind command to the source 


input lu at the end of 
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each pass. 


Message (MSG) Instruction 


The message instruction allcws the programmer to log a message to 
the system console. It has the form: 
NAME OPERATION OPERAND 

A symbol MSG Text 

(optional) 
The operand field contains the text of the message. All 
characters following the operation field, up to and including 
position 71, are sent to the system console as a message. This 


instruction can 
is logged on every pass. 


328.7213 


The batch assembly instructions provide a 


appear anywhere in the progran, 


Batch Assembly (BATCH, 


and the message 


BEND) Instructions 


means for assembling 


more than one complete program in a batch stream. They have the 
form: 
NAME CPERATICN CPERAND 

None PATCH Not used 

(illegal) (ignored) 

None BEND Not used 

(illegal) (ignored) 
The batch instruction (RATCH) initiates the batch stream. It has 
the effect of redefining the END instruction so CAL/32 does not 
terminate itself at the end of the required number of passes. 
Rather, CAL/32 terminates the assembly of that particular 
program, reinitializes itself, and starts reading the next 
program from the source input file. The BATCH instruction must 
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be the first statement in the stream of programs. If it is used, 
CAL/32 assumes that there is a scratch device. Options specified 
in the operating system START command remain in effect for the 
entire batch assembly (see Appendix A). 


The batch end instruction (BEND) terminates the batch assembly. 
It must appear immediately following the END instruction in the 
last program cf the stream. The BEND instruction tells CAL/32 to 
go to end of task when final assembly is completed. The end of 
task code returned is equal to the highest code generated during 
the batch assemblies. CAL/32 will also terminate a batch 
assembly normally if end of file or end of medium status is 
detected when attempting to read the first statement after the 
END of an assembly. 


3.8.7.-14 Unreferenced Externals (UREX, NUREX) Instructions 
These instructions permit or suppress the output of object code 


for unreferenced externals.- The default state is UREX. They 
have the form: 


NAME OPERATION OPERAND 
Not used UREX Not used 
(ignored) (ignored) 
Not used NUREX Not used 
(ignored) (ignored) 


3.8.8 Conditional Assembly Instructions 


These instructions allow the programmer to include in the program 
code segquences that may or may not be assembled, depending on 
some condition. By. simply reassembling the program and 
redefining the conditions, a single program can be made to serve 
more than one purpose. 


3-8.-8.1 Compound Conditional (IFx, ELSE, ENDC) Instructions 


There are three instructions in this set. They have the form: 


NAME OPERATION OPERAND 
A symbol IFx A symbol or 
Coptional) expression 
A symbol ELSE A symbol or 
(optional) expression 
(ignored ) 
A symbol ENDC A symbol or 
(optional) expression 


(ignored ) 
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The compound conditional instructions are used to provide 
complete conditional assembly capability. A symbol used in the 
name field of an IF instruction is defined if the condition 
described by the instruction is true. A symbol used in the name 
field of an ELSE instruction is defined if the correspondng if 
condition is false. Symbols used in the name fields of end 
condition instructions are always defined. 


In the first instruction, the compound IF instruction, X 
represents the actual condition... Following is a list of the 
various mnemonics for these instructions: 


MNEMONIC MEANING MNEMONIC MEANING 
I FZ If zero IFNM If nonminus 
IFNZ If nonzero IFE If even 
IFP If plus IFO If odd 
IFNP If nonplus IFU If undefined 
IFM If minus IFD If defined 


CAL/32 tests the value of the operand when processing compound IF 
instructions. If the operand meets the condition specified by 
the operation, the instructions immediately following the IF 
instruction are assembled. If the operand does not meet the 
specified condition, the instructions immediately following the 
IF instruction are not assembled. 


The FLSE instruction reverses the state of the assembler as set 
by a previous compound IF statement. If the assembler was not 
assembling code because a previous IF statement turned off the 
assembly process, the aprearance of an ELSE instruction would 
cause the assembler to resume assembling, starting with the 
instruction immediately fcllowing the ELSE instruction. If the 
assembler was assembling code because a previous if condition was 
met, the appearance of the ELSE instruction would cause the 
instructions immediately following the else instruction not to be 
assembled. An ELSE instruction is not required to appear ina 
block of conditionally assembled code. 


The third instruction of this set is the end condition 
instruction (ENDC) which terminates the presently active 
condition. Normal assembly process resumes with the next 
instruction. Any compound IF instruction used in the program 


must have a corresponding ENDC instruction. If the end of the 
source file is reached before an existing condition terminates, 
CAL/32 terminates the condition, generates an error message, and 
resumes normal assembly cn the next passe If the operand of the 
IFx contains a forward reference, CAL/32 will perform any 
additional passes required to define all symbols. As an example 
of conditional assembly, consider a subroutine that can receive 
its parameters in either of two ways: first, the parameters are 
located by referencing a list of addresses 
immediately following the branch and link instruction in the main 


48-050 FOO R00 3-5] 


program; second, the address of the actual parameter list is 
contained in register 14. The subroutine could handle both of 
these situations with conditional assembly, as follows: 


IFZ CALL1 


SUB LH R1,0(RF) GET FIRST PARAMETER ADDRESS 
LH R1,0(R1) GET FIRST PARAMETER 
LH R2,2(RF) GET SECOND PARAMETER ADDRESS 
LH R2,0(R2) GET SECOND PARAMETER 
AIS RF, 4 ADJUST RETURN ADDRESS 
ELSE LIST NOT IN LINE 
SUB IH R1,0(RE) GET FIRST PARAMETER 
LH R2,2(RE) GET SECOND PARAMETER 
ENDC 
RETURN BR RF RETURN TO CALLER 


If at assembly time, the value of CAL1 is zero, the instructions 
between the IF instruction and the ELSE instruction are 
assembled, and the instructions between the ELSE instruction and 
ENDC instruction are not assembled. If the value of CAL1 is 
other than zero, only the instructions between the ELSE 
instruction and the ENDC instruction are assembled. 


Another example of conditional assembly shows how conditions can 
be nested: 


IFNP LGTH CONDITION #1 

* ERROR. 4 LGTH IS NOT POSITIVES 
ELSE CONDITION #1 
IFZ SRC+ DS. CONDITION #2 

* ERROR: “2 SRC IS EQUAL TO DST 
Bago CONDITION #2 
LHL R1,LGTH 
IFP S:RC=DST CONDITION #3 


LHI R2-,SRC 

LHI R3,DST 

PLor CONDITION #3 
LHI R2,DST 

LHI R3,SRC 


ENDC END CONDITION #3 
ENDC END CONDITION #2 
ENDC END CONDITION #1 
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This set of nested conditionals depends on 
symbols: LGTH, SRC, and DST. If LGTH is 
the comments: 


* ERROR 1 


three 
only 


the values) of 
negative or zero, 


LGTH IS NOT POSITIVE 


is produced. If LGTH is positive, and SRC is equal to DST, only 
the second comment: 

*  ERRCR 2 SRC IS EQUAL TO DST 
is produced. If LGTH is positive, and SRC is greater than DST, 
the following instructions: 

LHI R1,LGTH 

LHI R2,SRC 

LHI R3,DSC 
are assembled. If LGTH is positive, and SRC is less than DST, 
the following instructions are assembled: 

LHI R1,LGTH 

LHI R2,DST 

LHI R3,SRC 
The user must be careful, when using a forward reference in the 


operand field 
of code: 


of the IFU instruction, 


IFU A 

B EQU 8 
ENDC 

A QU 1 
IFNZ B 
LS 10 
ENDC 

B EQU 0 
END 
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to avoid the following type 


CAL/32 will flag this code with an "M001 xxxTOP" error where xxx 
is PURE, IMP, or ABS, depending upon the location counter used. 


NOTE 


A condition once set by an IF instruction 
remains in effect until the corresponding 
ENDC instruction is encountered. Thus, 
when the first condition was met, the 
first comment was produced. The ELSE 
instruction reversed this state, and no 
subsequent code was assembled. 


4 


3.8.8.2 Simple If (IF) Instruction 


The simple IF instruction is retained in CAL/32 to maintain 
compatibility with previous assemblers. It has the form: 


NAME CPERATICN CPERAND 
A symbol IF A symbol or 
Coptional) expression 


What CAL/32 does on encountering an IF instruction depends on the 
value of the cperand. If the operand has a nonzero value, CAL/32 
assembles all statements following the IF instruction, until the 
end of the source file is reached, or until another IF 
instruction is encountered in which the operand value is zero. 
At this point, CAL/32 stops assembling the source input until the 
ENC instruction, or another IF instruction with a nonzero operand 
value, is encountered. If the operand contains a forward 
reference, CAL/32 will perform any additional passes reguired to 
define all symbols. 


NOTE 


To not use simple IF instructions and 
compound IF instructions in the same 
orograMe Simple IF instructions must not 
be used in nested conditionals. 


3.8.8.3 Do (DO) Instruction 


The DO instruction provides a form of conditional and multiple 
assembly cavability. It has the form: 


NAME OPERATION OPERAND 
A symbol DO A symbol or 
(optional) expression 
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The PO instruction causes the statement immediately following it 
to be assembled as many times as Specified by the value of the 
operand. The value of the cperand must be between 0 and 32,767. 
If the value of the operand is 0, the next instruction is 
skipped. If the operand contains a forward reference, CAL/32 
will perform any additional passes required to define all 
symbols. 


The user must guard against circular location counter dependency, 
as in the following example: 


A EQU x 
DO B-A 
DS 2 

B EQU * 
END 


CAL/32 will flag an “MOO1 xxxTOP” error, where xxx is PURE, IMP, 
or ABS, depending upon the current location counter. 

3.8.9 Instructions for Data Structures 

These instructions allow the programmer to define complex data 
structures. Some of these instructions allow the programmer to 
define and initialize data blocks compatible with FORTRAN common. 
3.8.9.1 Structure Definition (COMN, STRUC, ENDS) Instructions 


Structure definition instructions are used to define data 
structures. They have the form: 


NAME OPERATION OPERAND 
A symbol COMN Not used 
(optional) (ignored) 
A symbol STRUC Not used 
(optional) (ignored ) 
A symbol ENDS Not used 
(optional) (ignored) 


The common instruction (CCMN) defines FORTRAN compatible common 
blocks. The structure instruction (STRUC) defines other types of 
data structures. The end structure instruction (ENDS) terminates 
both common definitions and data definitions. 


The symbol in the name field of a  COMN or STRUC statement 
contains the absolute value of the length of the structure or 
commen block. The symbol specified with the ENDS instruction is 
associated with the current value of the offset counter. 
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A symbol is always required in the name field of a COMN 
instruction. To define FORTRAN compatible blank common, a 
special symbol consisting of two slashes (//) must appear in the 
first two positions of the name field. The remaining positions 
must be blank. If the name field is blank, CAL/32 will assume 
(//) was intended for a FORTRAN blank common. 


The scope of the common block consists of all the storage 
definitions between the COMN instruction itself and the next ENDS 
statement. Only define storage, origin, and equate instructions 
are permitted between a  COMN and its corresponding ENDS 
instruction. The define storage instructions included within the 
common block definition do not actually reserve storage; they 
define offsets within the common block. Origin statements can be 
used to modify the offset ccunter. The equate instructions can 
be used to define symbtols relative to elements in the common 
block. Common blocks cannot be nested within other common blocks 
or within other structure definitions. 


The following is an example of the definition of FORTRAN 
compatible common blocks: 


C FORTRAN PRCGRAM 
INTEGER*2 I,J,K,KK,K2,1L 
COMMON A(10), I, J(€3,20) 
COMMON/COMONE/E( 30), K(4), KK 
CCMMON/COMTWO/XK,Y,Z,K2,L(24) 


The CAL/32 code to define these common blocks is: 


// COMN LEFINE BLANK COMMON 
A DS 4O TEN FLOATING POINT NUMBERS 
Re DS =. 2 ONE TWO-BYTE INTEGER 
J DS 120 SIXTY TWO-BYTE INTEGERS 
ENDS | END OF BLANK COMMON DEFINITION 
COMONE COMN DEFINE COMMON BLOCK COMONE 
B DS 129 THIRTY FLOATING POINT NUMBERS 
K DS 8 FOUR TWC-BYTE INTEGERS 
KK BS 2 ONE TWO-BYTE INTEGER 
ENDS END COMMON BLOCK COMONE 
COMTWO COMN - DEFINE COMMON BLOCK COMTWO 
X DS 4 ONE FLOATING POINT NUMBER 
Y DS 4 ONE FLOATING POINT NUMBER 
vA CS 4 ONE FLOATING POINT NUMBER 
K2 DS 2 CNE TWO-BYTE INTEGER 
L cS us TWENTY FOUR TWO-BYTE INTEGERS 
ENDS 
Common block definitions must precede any statements that 
reference the common block. Referencing a common element plus a 
displacement is permitted in the operand of a machine 


instruction, ina define constant instruction, or ina block data 
origin instruction defined Lelow. 
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STRUC is used to define general purpose data structures. The 
scope of this data structure consists of all the storage 
definitions between the structure instruction and its 
corresponding ENDS instruction. Only define storage, origin, and 
equate instructions can be used in a structure definition. The 
define storage instructions do not actually reserve storage; they 
define offsets within the data structuree Origin statements can 
be used to modify the value of the offset counter. Equate 
statements can be used to define names relative to elements in 
the data structure. Data structures cannot be nested within 
other data structure definitions or within common block 
definitions. 


To define a linked list structure, each node of which contains a 
2-byte forward pointer, a 2-byte backward pointer, six bytes, and 
a set of values such as: four bytes, one byte, one byte and six 
bytes, the programmer might write: 


NODE STRUC 

FWD DS 2 DEFINE FORWARD POINTER 
BAK DS Z DEFINE BACKWARD POINTER 
VALA DS 4 DEFINE FOUR-BYTE VALUE 
VALB DS 1 DEFINE ONE-BYTE VALUE 
VALC DS 1 DEFINE ONE-BYTE VALUE 
VALD DS 6 DEFINE SIX-BYTE VALUE 

ENDS 


The effect of this definiticn is the same as: 


NOCE EQU 16 
FWD EQU 0 
BAK EQU 2 
VALA ° EQU u 
VALB EQU 8 
VALC EQU 9 
VALD EGU 16 


Once NODE is defined, it can be used as follows: 


LHI R5,POCL GET ADDRESS OF POOL 

LB RO,VALB(R5) GET VALUE B OF FIRST NODE 

LH R5,FWLDCR5) GET POINTER TO NEXT NODE 
POOL DS 1G0*NODE 
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Data structure definitions must precede any references to their 
elements in RX3 format instructions, unless the NORX3 instruction 
or the SQUEZ instruction was used. 


3.8.9.2 Structure Initialization (BDATA, BORG) Instructions 
Structure initialization instructions define FORTRAN compatible 


block data subprograms that consist of labeled common blocks. 
They have the form: 


NAME OPERATION CPERAND 
A symbol BDATA Not used 
(optional) (ignored) 
A symbol BORG Not used 
(optional) (ignored) 


The block data instruction (BDATA) must precede any statements 
that generate data, and the block data subprogram must not 
contain any executable code. The common blocks to be initialized 
must be defined at the beginning of the block data subprogran. 
Once they are defined, the block origin instruction (BORG) is 
used to initialize the data elements of the common blocks. The 
operand of the block origin instruction consists of the common 
block name followed immediately by the element name or its 
displacement enclosed in parentheses. Only one operand is 
allowed. The following is an example of a block data subprogram: 


BDATA 
* 
* COMMON BLOCK DEFINITION 
* 
BLK  CCMN 
A DS m 
R DS 40 
Y DS 20 
Z DS 4 
ENDS 
* 
* INITIALIZE ELEMENTS A, B+8, AND Z 
* 
BORG BLK(A) REFERENCE BY NAME 
Dc Bt tO" 
BORG BLK(64) REFERENCE BY DISPLACEMENT 
pC E*20* 
BORG BLK(B+8) REFERENCE BY NAME AND 
DISPLACEMENT 
DC E*30° 
END 


This program initializes A to a floating point value of 103: Z to 
a floating point value cf 203 and the third fullword, B, to a 
floating point value of 30. 
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3.8.10 Listing Control Instructions 


These instructions allow the programmer to exercise some control 
over the format and the content of the source listing produced by 
CAL/32 on the final pass of the assembly. 


3.6.10.1 Listing Identification (PROG, TITLE) Instructions 
Listing identification instructions are used to force CAL/32 to 


print header information at the top of each page of the source 
listing. They have the ferm: — 


NAME OPERATION OPERAND 
A symbol PROG Text 
(optional) 
A symbol TITLE Text 
(optional) 


The program instruction (PROG) specifies the primary heading for 
each page of the listing. In addition, it causes the symbol in 
the name field to be placed at the beginning of the object file 
for program identification. On 16-bit assemblies, only the first 
six characters of the name field are put in the object file. 


All characters in the operand field (a maximum of 56) up to and 
including position 71 are printed in the primary header line of 
each page of the listing. If more than one PROG instruction is 
encountered in a module, the last PROG instruction will override 
all previous ones. 


The title instruction (TITLE) is a way to specify subheadings 
that can be changed within the programe The text contained in 
the operand field up to and including position 71, is printed on 
the line immediately below the heading produced by the PROG 
instruction. As many TITLE instructions as required can appear 
in the source input file. Bach time a TITLE instruction is 
encountered, CAL/32 starts a new listing page with the new 
subheading when the next printable statement is processed. 
Subsequent pages contain this same subheading, until another 
TITLE instruction appdears. plas two or more TITLE instructions 
occur together in seguence, only the last TITLE instruction 
affects the subheading content since a new page will be printed 
only when a printable statement is encountered. 


TITLE instructions themselves are not printed although they are 
included in the statement count. 
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3.8.10.2 Format Control (LCNT, EJECT, SPACE, WIDTH) Instructions 


Format control instructions allow the programmer to control the 
format of the listing. They have the form: 


NAME OPERATION OPERAND 
A symbol LCNT A symbol or 
(optional) expression 
A symbol EJECT A symbol or 
(optional) expression 
A symbol SPACE A symbol or 
(optional) expression 
A symbol WIDTH A symbol or 
(optional) expression 


The operand field of the line count instruction (LCNT) specifies 
the number of lines to be printed on each page of the listing. 
The operand value must be an absolute number no greater than 99 
and no less than 10. The default value of the line count is 58. 


Whenever the eject instruction (EJECT) appears, it overrides the 
specified or default line count, and causes CAL/32 to start a new 
page when the next printable statement is processed. The new 
page starts with whatever headings are in usee This statement is 
included in the statement count, but it is not printed. If one 
or more EJECT instructions occur together in sequence, only one 
page is advanced since the actual advance occurs only when a 
printable instruction is encountered. EJECT instructions 
themselves are not printed although they are included in the 
statement count. 


The operand field of the space instruction (SPACE) specifies the 
number of lines to be skipped in the listing. The value of the 
operand must be absolute. If the number of lines to be skipped 
exceeds the number of lines remaining on the page, this 
instruction has the same effect as an EJECT instruction and is 
included in the statement ccunt, but not printed. 


The operand field of the width instruction (WIDTH) specifies the 
number of columns to be printed across the page. The value of 
the operand field must be an absolute number, not greater than 
132 and not less than 64. The default value is 132. 


(ve) 
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3.8.10.3 Content Control (NLIST) Instructions 


The content control instructions control the content of the 


(optional) 


The no list instruction (NLIST) 
program. 


The list instruction (LIST) 
source statements are printed. 


listing. They have the form: 

NAME OPERATION OPERAND 
A symbol NLIST Not used 
(optional) (ignored ) 
A symbol LIST Not used 
(optional) Ciqnored) 
A symbol LSTC Not used 
(optional) (ignored) 
A symbol NLSTC Not used 
(optional) (ignored ) 
A symbol ERLST “Not used 
(optional) (ignored) 
A symbol LSTM Not used 
(optional) Cignored) 
A symbol NLSTM Not used 
(optional) (ignored) 
A symbol FREZE Not used 
(optional) (ignored ) 
A symbol NFREZ Not used 
(optional) (ignored ) 
A symbol CROSS Not used 
(optional) (ignored) 
A symbol NCROS Not used 
(optional) (ignored ) 
A symbol LSTUR Not used 
(optional) (ignored) 
A symbol NLSTU Not used 
Coptional) (ignored ) 
A symbol WARN Not used 
(optional) (ignored ) 
A symbol NWARN Not used 


(ignored ) 


reverses 


suppresses listing of the 
Only those statements that contain errors are printed. 


situation, 


source 


and 
The assembler default is to print 


all 


all source statements. 


The list conditionals instruction (LSTC) permits 
unassembled conditional assembly statements. 
default mode of the assembler. 


printing of 
This is the normal 


The no list conditionals instruction (NLSTC) suppresses printing 
of unassembled conditidnal etatements. 
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The error list instruction (ERLST) causes CAL/32 to print all 
assembly errors by type, along with number of each statement on 
which the error occurred, immediately after symbol table listing. 


The list macro instruction (LSTM) permits printing of all macro 
expansions that are part of the source input file. The macro 
instruction, the expanded scurce code, and the generated object 
code are printed. A plus character (+) precedes each statement 
number in the expanded source to identify those statements as 
part of a macro.e This is the normal mode of the assembler. 


The no list macro instruction CNLSTM) Suppresses printing of 
macro expansions. Only the macro statement itself is printed. 


The freeze (FREZE) instructicn halts incrementing of the 
statement counter when a copy file or macro expansion are 
included in the source inrut file. All statements in the copy 
file or macro expansion receive the same statement number as that 
of the COPY instruction. This is the normal mode of the 
assembler. 


The no freeze (NFREZ) instruction increments'7 the statement 
counter for every statement encountered in the source input. 


The cross reference (CROSS) instruction uses CAL/32 to generate 
and print a cross reference listing of all the symbols used in 
the program. Each symbol is listed in alphabetical order, along 
with identification of the statements in which it is referenced. 
The statement in which it is defined is flagged with an asterisk. 
This is the normal mede of the assembler. 


The ne cross (NCROS) instruction prevents the generation of a 
cross reference listing. 


The list unreferenced symbols (LSTUR) instruction causes 
unreferenced symbols to be listed in the symbol list. This 2s 
the normal mode of the assembler. 


The no list unreferenced symbols (NLSTU) instruction suppresses 
the listing cf unreferenced symbols in the symbol list. 


The warning (WARN) instruction allows CAL/32 to flag warnings in 
the listing and tally the number of warnings encountered. This 
is the normal mode of the assembler. 


The no warning (NWAKN) instruction suppresses both the warnings 
and the warning count from the listing. 


3.9 ASSEMBLY LISTING 


The assembly listing consists of two sections: the source and 
object program statements and the symbol cross reference table. 
The format for printing the source and object program statements 
is basically the same fcr either 16-bit assemblies or 32-bit 
assemblies. The only difference is in the number of characters 
printed for the location counter and the object data. 
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e In 16-bit assemblies, only four hexadecimal digits are printed 
for the Location counter, and a maximum of eight hexadecimal 
digits for the data. The letter R is appended to the location 
counter value if the relocatable location counter is being 
used. 


e In 32-bit assemblies, six hexadecimal digits are printed for 
the location counter anda maximum of 12 hexadecimal digits 
for the object data. In addition, the actual second operand 
address of RX2 and SF instructions is printed next to the 
object data. This address is preceded by an equal sign (=). 
The letter I is appended to the location counter if the impure 
location counter is being used. The letter P is appended to 
the location counter if the pure location counter is being 
used. 


e In both 16- and 32-bit assemblies, the letter F is appended to 
the data field to indicate that the statement references an 
externally defined symbol, a symbol in a common block, or an 
undefined symbol. 


The statement number is a decimal number between 1 and 99999. 
Fach source statement read by the assembler is assigned a 
unique statement number, beginning with 1, except for source 
statements from a copy file or macro expansion with the FREZE 
instruction. The first column of the listing can contain any 
of the following characters: 


CHARACTER MEANING 


I The name field of this instruction contains a 
symbol that was redefined by an EQUATE 
instruction. 


? A machine instruction not available on the 
target machine was used; an equivalent 
instruction existed and was substituted, or 


a machine dependent instruction was used in 
assembling a common mode program, or 


an assembler instruction was used with an 
improper but assemblable operand, or 


a SCRAT card was encountered as other than the 
first statement or when batch mode is in 
effect, or 


an EXTRN/ENTRY Symbol is longer than 6 
characters for target 16, or 


a DS instruction was encountered in a pure 
section. 


* A machine instruction was shortened or 
modified by squeezing. 
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The following information is printed at the beginning of the 
cross reference listing: 


® Start options in the START command 


® The number of errors detected by the macro processor if the 
program assembled was generated by the macro processor. 


® Number of CAL/32 errors and the page number of the last error 


® Number of CAL/32 warnings and the page number of the last 
warning 


® Number of passes 
® Message indicating the use of symbol table paging to disk 


® Message indicating abnormal termination of squeezing because 
of squeeze-induced errors 


® Message indicating the amount of required table space 


Following this, each symbol used in the program is listed in 
alphabetical order along with its value. If a cross reference 
was requested, the statement number of each statement containing 
a reference to the symbol is printed following the value. The 
statement number in which the symbol is defined is printed with 
an asterisk (*) following. Associated with each symbol is a flag 
used to indicate one of the following: 


FLAG MEANING 

¥ Properly defined local symbol 
M Multiply defined symbol 

U Undefined symbol 

< Entry Symbol 

<U Undefined entry 

> Externally defined symbol 

>i Multiply defined external 

ball Unreferenced external 


The flag is printed in the first column of the line containing 
the symbol. 


If an error is detected in a source statement, the following 
message is printed immediately after the error statement: 


EAR EYE 


A indicates the general type of error, and nnn is a decimal 
number that further identifies the error. Appendix B contains a 
complete list of CAL/32 error codes. 
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CHAPTER 4 
COMMON MODE PROGRAMMING 


4.1 INTRODUCTION 


A useful feature of Common Assembly Language/32 (CAL/32) is mode 
programming where a Single source file can be used to produce 
object code for either 16-bit processors or 32-bit processors. 
In creating a common mode source file, the programmer must be 
aware of certain restrictions and safeguards and, in some cases, 
must use special operaticn mnemonics that can be translated into 
either 16-bit or 32-bit operations. 


4.2 ADDRESS OPERATION INSTRUCTIONS 


Addresses for 16-bit processors occupy 16 bits, a halfword. For 
the 32-bit processors, addresses occupy the least-Significant 24 
bits of a fullword. In normal mode, CAL/32 makes no distinction 
between operations on address quantities and operations on other 
data types. However, when writing in common mode, the programmer 
must use svecial operation mnemonics for address operations. so 
CAL/32 can translate them into the correct target machine code. 
Table 4-1 lists these instructions, their mnemonics, and the 
target machine translations. 


TABLE 4-1 COMMON MODE ADDRESS OPERATIONS 


| | 
| | TRANS~ | TRANS- | 
{ INSTRUCTION | MNEMONIC | LATION | LATION | 
| HSS SES SSS SS HS SS SH KTS SS HSS SSS SSS SS SS SSS SSS SS SSS SSS SSS SS SS SSSSS | 
Add Address AA A AH 
Add Address Immediate AAI Al AHI 


a 
jon 
as 


| | | | 

| | | { 

Address RR {| AAR | AR | AHR | 
| | | | 

| | | | 


Add Address to Memory AAM AM AHM 

Compare Address CA c CH 
Tak cs ee cc eer | 
| Compare Address Immediate | CAI | cI {| CHI { 
| Compare Address RR | CAR | CR | CHR { 
{| Compare Logical Address } CLA | CL |} CLdA | 
| Compare Legical Address { | | | 
| Immediate | CLAI | CLI | CLHI [ 
|} Compare Logical Address RR | CLAR | CLR |} CLHR | 
|} Immediate | CLATI } CLI | CLHI | 
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TABLE 4-1 COMMON MODE ADDRESS OPERATIONS (Continued ) 


INSTRUCTION {| MNEMONIC | LATION | LATION 
J HS SRS HRS HSH SSS SH SSH SHH SHH SSH SHS SH SSS SHS STS SSS SSS S SSE SS Ss=SHSS=H | 
Load Address LDA L LH 
Load Address Immediate LDAI LA LHI 


| | | | | 
| | | | | 
|} Load Address RR |] LDAR { LR | LHR | 
| | | | | 
| | | | | 


AND Address NA N NH 

AND Address Immediate NAI NI NHI 
|-------- wo no nn enn nn nn nnn nnn nnn 2 2 2 2 22-2 2-2 - = | 

AND Address RR NAR NR NHR 

OR Address OA 0) OH 


| | | | | 
| | | | | 
{ OR Address Immediate {| OAI } OT | OHI | 
| | | | | 
| | { | | 


OR Address RR OAR OR OHR 
Subtract Address SA Sy SH 

ee iesede: eas ase San. > aT IE REE os oc | 
Subtract Address Immediate SAI SI SHI 
Subtract Address RR SAR SR SHR 


| | | | | 
| | | | | 
| Shift Left Address Arithmetic | SLAA | SLA | SLHA | 
| | | | | 
| | | | | 


Shift Left Address Logical SLAL SLL SLHL 
Shift Right Address Arithmetic SRAA SRA SRHA 

liars eoakeraiten gt cre cieietceaie ve haa wien ws ree eee i oe | 
Shift Right Address Logical SRAL SRL SRHL 
Store Address STA ST STH 


| | | | | 
| | | | | 
{| Test Address Immediate | TAI | TI | THI | 
| I | | 
| { | [ I 


Exclusive OR Address XA X XH 
exclusive OR Address Immediate XAI XI XHI 

leeches cee ae Sk we ey aes ae 
Exclusive OR Address RR XAR XR XHR 
Multiply Address MA M MH 


LTivide Address 
Livide Address KR 


-— a oe ee ee ee oe ee ee em am oe ne ae om ae @ @& ae @ oe = os om @ @& of ww @ @& oo @ of ee oe io ae & @ oe oe @ @ ow oe oe om ae ow oe om ow oe oe 2 ee oe 


| | | 

I | | 
Multiply Address RR | MAR | MR | MHR 

| | | 

| | | 


CAL/32 translates these instructions into halfword or fullword 
instructions, depending on the target machine. For example: 


LDA R1,ADCE1 


AA R1,DISP 
ADD1 DC A(TABLE) 
CISP DC Zz 
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When CAL/32 assembles these instructions for 16-bit execution, it 
produces object code that wculd normally correspond to: 


LH R1,ADD1 
AH R1,DISP 


For 32-bit programs, CAL/32 rroduces code that would correspond 
to: 


L R1,ADDP1 
A R1,DISP 


Translation is at the object code level; CAL/32 prints the 
Original common mode code on the listing. 


4.3 COMMON MODE IMMEDIATE OPERATIONS 


CAL/32 provides a common mode immediate operation for the load 
immediate LDI instruction. Depending on the target machine, the 
LDI is translated into a fullword-referencing LI instruction for 
the 32-bit machine, or a halfword-referencing LHI instruction for 
the 16-bit machine, as follcws: 


COMMON 32-BIT 16-BIT 
INSTRUCTION MNEMCNIC TRANSLATION TRANSLATION 
Load Immediate LDI LI LHI 


4.4 COMMON MODE ASSEMBLER INSTRUCTIONS 


In addition to all of the regular assembler instructions 
described in Chapter 3, CAL/32 recognizes four assembler 
instructions primarily for use in common mode programming. Two 


of these are data definition type instructions; the other two are 
assembler control type instructions. 
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ueu. Data Cefinition Instructions 


The common mode data definition instructions are: detine address 
length constant and define address length storage. They have the 
forms: 


NAME OPERATICN OPERAND 
A symbol DAC One or more operands 
(optional) separated by commas 
A symbol DAS A symbol or 
(optional) expression 


4.4.1.1 Define Address Length Constant Instruction 


The define address length constant instruction is equivalent to 


the define constant instruction. It is used in common mode 
programming to reserve storage to be initialized with address 
length constants. For 3z-bit assemblies, the constants are 


fullwords aligned on fullword boundaries. For 16-bit assemblies, 
the constants are halfwords aligned on halfword boundaries. 


&.4.1.2 Define Address Length Storage Instruction 


The define address length storage instruction is equivalent to 


the define storage instruction. In 32-bit assemblies, the 
instruction reserves the specified amount of fullwords aligned on 
a fullword boundary. In 16-bit assemblies, it reserves’ the 


specified amount of halfwords aligned on a halfword boundary. 
Examples of the use of these instructions are: 


DAC A(TABLE) 
DAS 16 
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When assembled for 32-bit execution, the define address length 
constant instruction generates a fullword containing the address 
of TABLE. The define address length storage instruction reserves 
16 fullwords of storage. When assembled for 16-bit execution, 
these instructions cause CAL/32 to generate a halfword containing 
the address of TABLE, along with a storage area of 16 halfwords. 


NOTE 
Define address length storage instruc- 
tions can be used in common block and 
structure definitions. 
4.4.2 Assembler Control Instructions 


Two special assembler instructions control error checking. Their 
form is: 


NAME OPERATICN ~ OPERAND 
A symbol CAL/32 Not used 
(optional) (ignored ) 
A symbol NCCAL Not used 
(optional) (ignored) 


The first of these instructions (CAL/32) establishes the common 
mode and enables common mode error checking. In this mode, any 
machine dependent instructicn causes a nonfatal error, and a 
warning flag is printed on the assembly listing. 


The NOCAL/32 instruction disables the common mode and itS error 
checking mechanisms until the next CAL/32 instruction is 
encountered. This is the assembler default mode in which an 
operation code mnemonic, not valid for the targeted processor but 
for which there is a valid equivalent, is assembled using the 
valid equivalent. A questicn mark (?) is then printed in the 
left hand margin of the listing. 


4.5 MIXED MODE COMPUTATICNS 


On 32-bit processors, mixed mode computations, such aS adding a 
halfword guantity to an address length quantity contained ina 
register, can be performed. In general, any halfword arithmetic 
Or logical operation can be performed on address length 
quantities contained in registers. The exceptions are: shifts, 
multiply, and divide. The halfword forms of these instructions 
should never be used with address length quantities. Instead, 
use the special address oferation instructions. 
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4.6 GLOBAL SYMBOLS 


The global symbols, ADC and LADC, are used primarily in common 
mode programming. In 32-bit assemblies, ADC has a value of four, 
the length in bytes of an address length constant. LADC has a 
value of two, the log (base 2) of the address length. In 16-bit 
assemblies, ADC has a value of two, and LADC has a value of one. 
Illustrated are these symbol uses in which a main program calls 
a subroutine and passes parameters to the subroutine ina list of 
addresses immediately following the branch and link instruction: 


BAL RF,SUB 
DAC ACPARM1),ACPARM2),A(PARM3) 
RETURN EQU * 


The subroutine picks up the parameters and calculates the return 
address as follows: 


SUE AIS RF, LALC ADJUST RF FOR 
NAT PF,-ALC ALIGNMENT 
LDA R1,0CRF) ADDRESS OF FIRST PARAMETER 
LDA Kk2,ADCCRF) ADDRESS OF SECOND PARAMETER 
LD R3,2*ADCCRF) ADDRESS OF THIRD PARAMETER 
SUBEND RP 3*ADCCRE) RETURN TO CALLER 


The add immediate short instruction and the add address immediate 
instruction are needed in the subroutine because alignment of 
address constants in 32-bit assemblies can cause a halfword of 
filler to be inserted between the branch and link instruction and 
the first address constant. In this case, the address in 
register 15 is the address of this halfword, and these 
instructions increment the address in register 15 to make it 
point to the first address constant. If no filler is required, 
because the first constant is naturally aligned on a fulilword 
boundary, register 15 points to the first constant, and these two 
instructions have no effect. 
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Another use of LADC is in shift instructions where a byte pointer 
must be converted into an address pointer, as3 


LB R1,INDEX GET BYTE POINTER 

SLAL R1,LACLC CONVERT TO ADDRESS POINTER 
LDA R2,TABLE(R1) GET ADDRESS FROM TABLE 

BR R2 


In 16-bit assemblies, LADC has a value of one, and the shift left 
logical instruction has the effect of doubling the value of the 
byte pointer, converting it into a halfword pointer. In 32-bit 
assemblies, LADC has a value of two, and the shift instruction 
has the effect of quadrupling the value of the byte pointer, 
converting it into a fullword pointer. 


The LADC symbol can also be used where machine dependent code 
must be written within a common mode program. For example: 


IFNZ LADC-14 IF TRUE USE 32 BIT CODE 

L RF,A LOAD FULLWORD IN RF 

A RF,8 ADD FULLWORD B 

Sc RF,A STORE IN A 

ELS LADC-1 IS FALSE USE 16 BIT 
LM RE,A LOAD FULLWORD IN RE AND RF 
AH RF,Bt+2 ADD LOW ORDER B 

ACH RE,B ADD HIGH ORDER 8B 

STM RE,A STORE IN A 

ENDC 


shows how fullword addition, requiring double registers in 16-bit 
assemblies and single registers in 32-bit assemblies, can be 
handled in a common mode program. 
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4.7 SPECIAL INSTRUCTIONS 


By definition, the instructions load multiple, store multiple, 
and load PSW, operate on address length data. This is why there 
are no address operation mnemonics for these instructions. Where 
these instructions are used in common mode programming, the data 
on which they operate must be defined by'‘the define address 
length constant and the define address length storage 
instructionse For example: 


e 


LPSW NEWPSW 


OTART STM RO,SAVE 
LM RO, PARAM 
NEWPSW DAC STATUS, ACSTART) 
RSAVE DAS 16 
FARAM DAC CON1,CON2,..e-. 


List processing instructions operate on address length quantities 
within the list. There ig Some incompatibility between the 16- 
and the 32-bit versions of these instructions. The 16-bit list 
instructions require byte pointers at the head of the list. The 
32-bit list instructicns require halfword pointers. List 
instructions can be used in common mode programming as long as 
the number of slots in the list does not exceed 255. 
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Lists always should be defined with the define list instruction. 
Use byte instructions where it iS necesSary to refer to the list 
pointers in the program. Define displacement into the list 
pointer fields in terms of the LADC-symbol. For example: 


SLOTS EQU LADC-1 : NUMBER OF SLOTS 
USED FQU 2*LADC-1 NUMBER USED 
CTOP EQU 3*LADC-1 CURRENT TOP 
NBOT EQU 4*LADC- 1 . NEXT BOTTOM 

LB R1,LIST+CTOP 
LIST DLIST 32 


In this example, the load byte instruction is used along with the 
value of CTOP to access the current top pointer in the list. 
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APPENDIX A 
COMMON ASSEMBLY LANGUAGE/32 
(CAL/32) OPERATING INSTRUCTIONS 


The CAL/32 assembler requires a minimum of one lu and up to a 
maximum of 11 logical units for operation, depending on the 
options selected and the features invoked by the source program. 
All of these logical units can be assigned by the user. However, 
if an lu is needed and not assigned, CAL/32 will allocate 
temporary system files for logical units 4, 5, 6, 8% 9, 12, and 
13. CAL/32 will delete and reallocate permanent files for 
logical units 2 and 3, provided they were not previously assigned 
and the DEL start option was specified. The logical units used 
ares: 


l | LOGICAL | ALLOCATED | REQUIRED | 
LU | USE | RECORD | BY CAL/32 | FOR 


elena dl a atihcenatiemr tan ttasedi-conteadliiennditantirasdiaandianat-adiinaalltrecdnaadl-ndiacdi-rcetthene-damdiandl —-Eaedieatlh nal -osthegedie-dietallt-adl <alheendnn Aen Manel ened an MA A ol a Eee OE dl 


Re en nen en SS SS 


1 No All 


Source input device. 
The source input to be 
assembled is read from 


this device on pass 
onee This device is re- 
wound prior to each 


subsequent pass unless 
BATCH is specified and 
the source input is not 
on a random access 
device, or SCRAT or 
PPAUS is specified. 


108 T=16 
126 T=32 


If DEL 
specified 


{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
Binary output device. | All 
Assembled object pro- | 
gram is written to this | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


device on last pass. 


64 - 132 If DEL 


specified 


Assembly listing output All 
device. Assembly list- 
ing is written to this 
device on the last pass. 
80 SCRAT 


BATCH 


Source scratch device. Yes 
The source input is 
copied to this device 
during pass one. The 
source input is read 
from this device on all 


subsequent passes. 
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a 


ALLOCATED |{ REQUIRED | 


Symbol cross reference 
scratch device. Cross 
reference infornation 
is built on this device 
during the last pass. A 
device assigned to this 
lu must support random 
access. 


Symbol table paging 
device. Symbol table 
information is paged to 
this device during all 


passes. A device 
assigned to this lu 
must Support random 
acceSSe 

Source library input 


device. Source inforn- 
ation to be included in 
the main assembly is 
read from this device 


on each pass unless 
SCRAT or BATCH was 
specified. Then the 


library is searched and 
read on pass one only. 


Forward equate scratch 
device. This lu can be 
used if forward refer- 
enced equates exist in 
the source input. This 
device must support 
random access. 


Error tabulation device 
Error messages and 
their associated line 
numbers are written in 
binary to this device 
during the last fass 
and written to lu 3 
after completion of the 
assembly and symbol 
table listing. 


LOGICAL 
RECORD 


80 


256 


80 


BY CAL/32 | FOR | 
| 

Yes | CROSS | 
| | 

| | 

| | 

| | 

| | 

| 

| | 

| | 

Yes {| Insuffi- | 
| cient | 

{ memory | 

| | 

| | 

| | 

| | 

| | 

| | 

No | COPY | 
| | 

| | 

{ | 

| | 

| | 

| | 

{ | 

| | 

| | 

| | 

Yes | Forward | 
{ equates | 

| | 

| | 

| | 

| | 

| | 

| | 

Yes | ERLST | 
| | 

| | 

| | 

| | 

| 

{ 

| | 

| | 

l { 
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random access. 


| |} LOGICAL | ALLOCATED | KEQUIRED | 

LU | | RECORD | BY CAL/32 | FOR | 
an ne a a a a a a a a a a a a a end | 
12 | PCB file directory | 256 | Yes |} CLIB | 
| scratch device. This | | | | 

| device Support | | | | 

| random access. | | | | 

| | | | | 

13 | PCB name directory | 256 | Yes | COPY | 
| scratch device. This | | | | 

| device support | | | | 

| | | | | 


When an assembly terminates, an end of task code is passed to the 


operating 


system 


in the operand field of the SVC 3 instruction. 


The meanings of the possible end of task codes are: 


END OF 
TASK CODE 
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MEANING 


Assembly complete without errors. 


Tllegal option passed with the START command. 
Assembly is aborted after logging the illegal 
options to the console. The user should 
retry. 

One or more errors detected during the 


assembly. This end of task code is also used 
if errors are detected in one or more programs 
of a batch assembly. 

Misplaced BEND. 


Symbol table overflow. 


When operating under 0OS/32, CAL/32 accepts certain control 
options as arguments of the START command. Any combination of 
Spaces and/or commas can separate or follow the options 
specification: 


START 

OPTION OPERANDS 

PPAUS None 

CROSS None 

NLIST None 

NORXT None (alias for NORX3) 

SQUEZ Number of passes (1-99) 

SOCHK None 

SCRAT None 

TARGT 16 or 32 

WIDTH Width of listing 

LCNT Lines per page (10-99) 

ERLST None 

ERSQZ None 

NLSTC None 

CAL None 

NLsSIM None 

BATCH None 

FREZE None 

NDISK None (inhibits symbol table paging to disk) 

NEIX None (prevents CAL/32 from making 
extra passes to fix squeeze-induced errors) 

DEL None 

LEST None 

LSTC None 

LSTM None 

LSTUR None 

UREX None 

WARN None 

NCROS None 

NDEL None 

NEREZ None 

NLSTU None 

NOCAL None 

NOSQ2Z None 

NOSEOQ None 

NUREX None 

NWARN None 

NORX3 None 


Start options have the following form: 


option [ =operand] 
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A typical start command for a CAL/32 assembly with start options 
is: 


ST ,DEL,SQUEZ=99,NCROSS 


The delete start options (DEL, NDEL) enable or disable CAL/32 
from deleting and reallocating object and listing files when 
needed. If the DEL option is in effect and lu 2 and lu 3 are 
unassigned, CAL/32 will delete, reallocate, and assign them to 
fname.OBJ and fname.LST, respectively.. The default option is 
NDFL, in which case CAL/32 will simply log an 8100 error to the 
console and pausee In the event that lu 1 is not assigned to a 
direct access device, the DEL option will have no effect, and 
CAL/32 will issue an 8100 error before pausing. 


When CAL/32 encounters conflicting start options such as _ CROSS 
and NCROS, it will regard the last option encountered as the 
intended option. This allows the user to redefine the default 
start options via CSS. For example: 


LO CAL32 

AS 1,SOURCE.CAL 
ST ,NCROSS DEL @1 
SEXIT 


The above CSS effectively changes the default options to NCROSS 
and delete unless overridden by the parameter ai. 


OPERATING INSTRUCTIONS FOR 0S/32 


CAL/32 will not run on a 16-bit machine, however it will still 
produce 16-bit object code if requested. 


Before using CAL/32 under OS/32, the relocatable object supplied 
Must be established as an OS/32 task, using Linke A typical 
command sequence using Link to establish CAL/32 is: 


LO .BG,LINK 
T BG ! 
ST | 
>ES TA 

>OP work=5000, SYS=FFFFF, SEG 
>IN CAL32 | 
>BU CAL32 
>END 


7ROL 
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CAL/32 is segmented into pure and impure code for Shared use with 
OS/32 systems that support this capability. To. establish CAL/32 
as a nonsharable task, remove the SEG option from the above 
command sequence. TET can be used instead of Link provided the 
source does not contain any of the following instructions: 
external with offset, DNTRY, WNTRY, WXTRN, INCLD, DCMD. 


A typical command sequence to establish CAL/32 using TET is: 


LO .BG,TET32 Load TET32 

AS 5,CON: Assign interactive device 
AS 7,CON: 

AL TETSCRT,IN Allocate and assign scratch 
AS 4,TETSCRT 

ST 

ES TA Establish task command 

IN CAL32.0ORJ Read CAL/32 object 

FXP 80 Get 20kb for symbol table 
BU TA,CAL/32 Build CAL/32 task 

MAP PR: Obtain map 

END 


The established CAL/32 task can then be loaded with the LOAD 
command and devices or files assigned as required. For example: 


LO .BG,CAL32 


T  .BG 

AS 1,PROGRAM.CAL,SRO Scurce input 

AS 3,PR: Assign listing device 
ST ,DEL,SQUEZ Start assembly 


When assembly is completed, CAL/32 terminates through the 
operating system, which logs the message: 


END OF TASK n 


where n is the end of task code. 


The files used for scratch, cross reference, paging, forward 
equates, PCB file directory, PCB name directory, and error 
summary will be allocated by CAL/32 as temporary operating system 
files if they are needed and were not vreviously assigned by the 
uSeEL. 
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A001 


A002 


A003 


B00 1 


BO0O2 


C00 1 


D001 


E00 1 


FOC 1 


FOQ02 


F003 


FOO4 


APPENDIX B 


COMMON ASSEMBLY LANGUAGE/32 (CAL/32) ERROR CODES 


the address 


the address 


the operand 


alignment 


alignment 


common mode 


data structure 


END placement 


missing operand 


register 
specification 


invalid source 
field 


invalid symbol 
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The address is out of range for the 
specified instruction format. 


The address is out of range for an 
RX2 instruction. 


The operand of a previously squeezed 
instruction was changed making the 
squeezed instruction invalid. 


The address of the operand iS On an 
incorrect boundary for the 
instruction specified. 


An odd address used in aT constant 
location counter was not even when 
the instruction was specified. 


An opcode that is not part of the 
common mode set is used in a common 
mode assembly. 


An illegal statement appears in a 
STRUC or COMN definition. 


An #ND statement was encountered 
within a STRUC or COMN definition or 
within an unterminated conditional. 


A register value is not in the 
range of 0 to 15, or an odd register 
value is used where an even value is 
required. 


Invalid label in the source field, 
a label in the name field is not 
followed by a space, or a required 
label is missing; eege, on EQU. 


More than 8 characters were 
specified ina symbol. 


FOO5 


F006 


FOO7 


F008 


FOO9 


F010 


F011 


F012 


EXTRN 


immediate field 


ENTRY 


delimiter 


invalid expression 


apostrophe 


invalid operand 


improper statement 


An invalid type for EXTRN; e.g., 
common block, or EXTRN was used in 
an expression. 


The value of data is too large to 
fit into the immediate field. A 
fullword EXTRN is’ used in R11 
instruction. A character string 
used as'an immediate field is too 
longe 


A symbol declared as an ENTRY is 
undefined. Improper type for ENTRY; 
@egGe, Common block name. 


Operands are not separated by 
commas. Unrecognizable operator. 
The last operand is not followed by 


a CR or a blank. Unbalanced 


parentheses. Opcode is not followed 
by a space or a CR. 


Expression uses common element names 
not in the same block. 


No ending apostrophe in C,D,E,F, 
H,-P,-Ue/X, or Y constant. Tllegal 
character encountered in 
C,D,E,F,H-P,U,X, or Y constant prior 
to the ending apostrophe. 


T constant was specified in TARGT 16 
assembly. Argument mode of Bb 
constant is not ABS, PURE, or 
IMPURE. Illegal data specified in 
BDATA program. Fullword EXTRN used 
as an operand of DCZ. Value of DB 
operand must be absolute. Value of 
DS, DSE, DSH. Invalid symbol used 
for ENTRY name. Symbol used as 
ENTRY must be ABS, PURE, IMPURE, or 
Relocatable. Invalid symbol used 
for EXTRN name. Invalid data in 
BORG. Operand of CNOP or ALIGN is 
not absolute. OQOperand of DLIST is 
not absolute. 


Improper type for EXTRN operand; 
@ege,y, common block name. Transfer 
address on END statement is an 
improper type; @ege, EXTRN. Illegal 
operand on EQU. 


Label only 
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F013 


FO14 


FOS 


[001 


MOO 1 


M002 


0001 


POO 1 


P0002 


R001 


5001 


5002 


5003 


file descriptor 


missing string 


invalid character 


conditional 


symbol definition 


symbol definition 


illegal opcode 


location counter 


reentrancy check 


relocation error 


sequence check 


COPY 


invalid option 
sequence 
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Syntax error on fd of a COPY, FCOPY, 
or CLIB statement 


No characters between apostrophes of 
C,E,D,F,H,P,U,X or Y constant 


Tllegal character encountered 
between apostrophes of an E or DPD 
constant. 


An ELSE or ENDC statement found 
without a matching IFx 


The symbol in the name field is also 
used in the name field of another 
statement. The value or type of a 
symbol changed from its definition 
on a previous passe (This can occur 
by illegal use of conditionals, ORG, 
DO, CS, or a misplaced SCRAT 
statement.) 


An attempt was made to redefine a 
Symbol with an EQU that is the name 
field of a statement. 


The opcode used is totally 
unrecognizable or illegal for the 
specified TARGT. 


The Location counter exceeded 216 on 
a TARGT-16 or 224 on a TARGT-32 
assembly. 


The instruction attempts to modify 
PURE code. 


An invalid combination of 
relocatable terms in an expression. 
A relocatable operand follows a 
unary minus. 


The value in the sequence numbers 
field is not greater than the 
previous sequence number. 


COPY statement appears within a file 
being copied. An invalid symbol 
used as COPY operand. The operand 
of CCPY is not followed by a space, 
comma, or CR. 


A COPY, PAUSE, MSG, or DO 
statement immediately follows a DO 
Statement. 


S004 


S005 


T0017 


TO02 


TOO03 


TOO4 


U001 


U002 


U003 


UOo4 


U005 


invalid option 


PROG 


overflow 


floating point 


value 


divisor 
not used 


undefined symbol 


undefined symbol 


An argument is not absolute or 
exceeds 32767. An argument of LCNT 
is in the range oft 10 to 99. An 


argument of WIDTH is not in the 
range of 64 to 132. An argument of 
TARGT does not evaluate to either 16 
or 32. An argument of SQUEZ is not 
in the range of 1 to 99. 


Multiple PROG statements were 
encountered in a program. 


The intermediate or final result of 
an arithmetic expression exceeded 
231 = 1. 

An overflow occurred during 


conversion of floating point 
constante 


The data item exceeds the range for 
specified type; e.ege, X'12345°. 


A division by 0 is attempted. 


A referenced symbol is not defined 
in the program. 


An attempt was made to circularly 
define a symbol; e.g.: 


A EQU B 
B EQU A 


File specified as an operand of 
FCOPY, CLIB, or COPY does not exist. 


Program name is not found in any of 
the PCB libraries. 
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APPENDIX C 
PERKIN-ELMER OBJECT CODE FORMAT 


Modules in Perkin-Elmer okject code format produced by CAL/32 are 
divided into records. Each record contains 126 bytes of 
information for 32-bit object code, or 108 bytes of information 
for 16-bit object code. The first 4 bytes of each record of the 
Object code format are organized as follows: 


woe ----- o> ED chatetetatatatetntatetatateteatatetetatatetetetatetntatete Se ptaketetetatetetatetetette 
| Sequence number | Checksum | 
mone rn ener nen § fen ewecccccnene Salatabaetatataneteieate $ fr-n------ ---- 
Bits: 

0 75> - 168 31 


The sequence numbers are seguential negative integers -1, -2, -3, 
etc., represented in two's complenent form. The first record in 
a program must have sequence number -1. Subsequent records must 
be in proper order to be loaded. 


The checksum is an exclusive OR sum of all halfwords in the 
record, except itself, plus a halfword of all 1's. 


The remainder of the record is a sequence of items; an item is a 
byte of loader information. There are two types of items--loader 
items and data items. Each loader item is followed by a certain 
number (which can be 0) of data items. The loader items and 
their meanings are listed in Tables C-1 and C-2. 
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sr cee ee ce ee es eee ee ee ee cs ce ce ei em ee ee ee ee cee em ee re ce ce ee ee ee ee ee ee ee ee ee 
ee a i er RN ee 


TABLE C-1 32-BIT LOADER ITEM DEFINITIONS 


LOADER | | NUMBER OF DATA 
ITEM | MEANING | ITEMS FOLLOWING 
SSS SSB SSS SSeS SSS SS SS SS SBS TTBS SSDS SSSSSBTASASRBTASAEASBSISBABSAES SS IRTT T= 

6) End of record | None 
1 End of program None 
2 Reset sequence number None 
3 Block data indicator 8-byte name, 


3-byte displacement, 
any absolute data 
item (20-5RB) 


| 

| 

| 

| | 

| | | 

| | | 

| | | 

| | 

| | | 

| | | 

4 | Absolute program address | 3-byte address { 
5 } Pure relocatable program | 3-byte address { 
| address | | 

6 { Impure relocatable program | 3-byte address { 
{ address { i 

7 {| 2 bytes of pure relocatable | 2-byte address | 
| data { | 

@ {| 2 bytes of impure | 2-byte address | 
| relocatable data { | 

9 | 4 bytes of pure relocatable | 4-byte address | 
| data { | 

A | 4 bytes of impure | 4-byte address | 
| relocatable data | ; | 

R | Common reference | 8-byte address | 
| | 3-byte displacement | 

C {| EXTRN | 8-byte name, fol- | 
| {| lowed by item 4, | 

| 5, or 6 | 

D |} ENTRY | 8-byte name fol- | 
{ {| lowed by item 4, | 

| | 5, or 6 | 

E |} Common definition | 8-byte name fol- | 
| | lowed by a 3 byte | 

| | length | 

F { Program label | 8-character name | 
10 { 3 bytes absolute and 3 | 6 bytes | 
| bytes pure relocatable | | 

11 | 3 bytes absolute and 3 |} 6 bytes | 
, | bytes impure relocatable | 
12 | Load program transfer | Item 4, 5, or 6 | 
13 | hefine start of chain | Item 4, 5, or 6 { 
| (reference) | | 

14 } Load chain definition | Item 4, 5, or 6 { 
{| address | | 

15 | 2 bytes absolute and 2 bytes| 4 bytes 
| pure relocatable | | 

16 | 2 bytes absolute and 2 bytes! 4 bytes H 
| | 


impure relocatatle | 
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TABLE C-1 32-BIT LOADER ITEM DEFINITIONS (Continued) 


} LOADER | | NUMBER OF DATA 
ITEM | MEANING | ITEMS FOLLOWING 
+7 Short form EXTRN 8-byte name and 


Item 4, 5, or 6 


18 Length of impure and pure 3-byte impure length 
segments and 3-byte pure 
length 
19 Perform fullword chain None 
1A Perform halfword chain None 
12 No operation None 
+E 2-byte pure translation 2 bytes 
table address 
1D 2-byte impure translation 2 bytes 
table address 
1E Not used N/A 
1F 1 byte absolute data 1 byte 
20 2 bytes absolute data 2 bytes 
21 4 bytes absolute data 4 bytes 
22 6 bytes absolute data 6 bytes 
23 8 bytes absolute data 8 bytes 
120 bytes absolute data 120 bytes 


symbol name 

i-byte flag 

xxxx xxO0O standard 
EXTRN 

xxxx xx0O1 weak 
EXTRN 

Xxxxx xx10 include 
EXTRN 

u“-byte offset 

Item 4, 5, or 6 


66 Extended entry 8-byte entry symbol 
: 1-byte flag 
xxxx xx00 standard 
entry 
xxxx xx01 data 
entry 
XXXX xx10 weak 
entry 
Item 4, 5, or 6 
67 Link commands 1-byte length 


1-80 characters 
of command 


oa) 
to 


| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
fl | 
5C-64 | Future use | 
| Extended EXTRN reference | 8-byte external 
| | 
| | 
| | 
| | 
| | 
| | 
| 
| | 
| | 
| 
| | 
| | 
| 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
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TABLE C-2 16-BIT LOADER ITEM DEFINITIONS 
| LOADER |} | NUMBER OF DATA | 
} ITEM | MEANING | ITEMS FOLLOWING | 
| BES SSS SSK SR SS MPSS SR SH SSeS Se SSS ees SS SSeS ess sees SRS SSS Esse see== | 
} Oo. | End of record | None | 
{| 1 | End of program | None | 
| 2 | Perform chain | None | 
| 3 | Toggle absolute/relocatable | None | 
| | mode | | 
| 4 | Transfer address | 2-byte address { 
, 5 { Load program address (ORG) | 2-byte address | 
| 6 | Load reference address | 2-byte address | 
| 7 | Load definition value { 2-byte address | 
{| & | 2 bytes absolute data j/ 2 bytes data | 
| 9 |} 2 bytes relocatable data | 2 bytes data | 
| A {| 4 bytes absolute data {| 4 bytes data | 
| B { 2 bytes absolute and 2 bytes| 4 bytes data | 
| | relocatable data | | 
| c |} EXTRN reference {| 6-byte name | 
| oO | ENTRY definition | 6-byte name | 
j £ | Decode next item | Next item | 
} EO | Declare common block | 6-byte name | 
| | ] 2-byte size | 
| §E1 | Load common block | 6-byte name { 
| | Gefinition value { 2-byte offset | 
| F2 |} 2 bytes absolute block data | 6-byte name | 
| | | 2-byte offset | 
| [ |} 2 bytes data | 
} £§E3 | 4 bytes absolute block data | 6-byte name | 
| | | 2-byte offset | 
| { | 4 bytes data | 
j EY | Reset sequence number to -1 | None | 
} ES | 1 byte absolute data | 1 byte data | 
| £56 {| 1 byte absolute Elock data | 6-byte name | 
| | | 2-byte offset | 
| { } 1 byte data | 
{| F | Program label | 6-byte name { 
All items are given in hexadecimal. Note that item E is actually 
a compound item whose interpretation depends on the item it 
follows. Item E and the following item are considered a single 
control item, however, and cannot be split across object records. 
This effectively allows mcre than 16 different control items, 


though most of them require only 1 nibble. 
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A 


Absolute (ABS) instructicn 


Absolute programs 
Absolute quantities 
ABSTOP 

Address length 


Address length constant (AIC) 


Address oferation instructions, 


address orprerations 

assembler 

immediate operations . 
Align (ALIGN) instruction 
Alignment, i 

ADC, effect on t 

CNOP, effect on 
Arithmetic expressions 


Arithmetic operators 


Assembler control instructions 


Assembler instructions, 
ABS 
ALIGN 
BATCH 
BDATA 
BEND 
BORG 
CLIB 
CNCP 
CCMN 
COPY 
CROSS 
DAC 
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INDEX 


reserved storage 

SCRAT 

SPACE 

SQCHK 

SQUEZ 

STRUC 

TARGT 

TITLE 

UREX 

WARN 

WICTH 

WNTRY 

WXTRN 
Assembly listing 
Asterisk, used as operand 


B 


Batch assembly instructicns, 
BATCH 
BEND 


Ind-1 


Batch end (BEND) instruction 
Batch (BATCH) instruction 


Binary language symbols, 
absolute values 
addresses 
constants 
cperation identifiers 
register identifiers 
Bicck data (BLDATA) instruction 
Branch and link instructions 


C 


CAL/32 inetructions 
Central processing unit (CEU), 
I/C interface 
local memory 
RSW 
registers 
Character symbols 
Comment statements, 
nonprintable characters 
printable characters 
Commen blocks 
Common (CCMN) instruction 
Common mode frogramming 
Compound conditional 
instructions, 
ELSE 
ENEC 
IFx 
Condition code 
Conditional assembly 
instructions 


Conditional branch instructions 
Conditional no operation (CNOP) 


instruction 
Content control instructions, 
CRCSS 
ERLST 
FREZE 
LIST 
LSTC 
LSTM 
LSTUR 
NCROS 
NFREZ 
NLIST 
NLSTC 
NLSTM 
NLSTU 
NWARN 
WARN 
Constant 
Constants, 
address 
character 
decimal string 
double precision floating 
point 
hexadecimal, 
DCX 
ccyY 
integer, 
fullword 
halfword 
internal representation 
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length 
packed decimal string 
Single precision floating 
point 
unpacked decimal string 
Constant tyres 
Copy (COPY) instruction 
Copy (CLIB) library 
instruction 
Cress reference (CRCSS) 
instruction 


D 


Data definition instructions, 
CAC 


GSH 
Data structures 
Cecimal symbols 
Define address length constant 
(CAC) instruction 


Define address length stcrage 
(TAS) instruction 

Define byte (DB) instructicn 
Lefine command (DCMD) 
instruction 


Define list (DLIST) instruction 
Define storage (0S) instruction 


CEL 

Delete start options 
DCF instruction 

DCX instructicn 

CCY instruction 
DNTKY instruction 

To (LO) instruction 


E 


Eject (EJECT) instruction 
ELSE instruction 

End condition (ENDC) 
instruction 

End (END) instruction 

End of task codes 

End structure (ENDS) 
instruction 

ENTRY instruction 

Equate instruction 

Errer codes 

FKrror list (ERLST) instruction 
Frror squeeze (FRSQZ) 
instruction 

Fxtended branch mnemonics 
EXTRN instruction 


Fields, 
name 
operand 
Operation 
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File copy (FCCPY) instruction 
Format control instructicns, 
EJECT 
LCNT 
SPACE 
WIDTH 
Freeze (FREZE) instructicn 


G 


Glcbal symbols, 
ABSTCP 
ADC 


IMPTCP 
LATC 


PURETOP 


H 


Hexadecimal symbols 


IJK 


Implicit symbols 
IMETOF 
Impure (IMPUR) instructicn 
Impure segments 
Include (INCLD) instruction 
Instruction statements, 
fixed format 
free format 
Instructions, 
address cperations, ccmiacn 
mode 
assembler 
assembler, common mode 
immediate operations, 
ccmmon mcde 
cperating 
16-bit machine 


32-bit machine 


Integer constants, 
fullword 
halfword 
internal representation 
I/C interface 


L 


LALC 
Line count (LCNT) instruction 
Linked list structures 
List conditionals (LSTC) 
instruction 
Listing control instructions 
Listing identification 
instructions, 
FROG 
TITLE 
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3-66 
3-66 
3-66 
3-66 
3-68 
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List (LIST) instruction 
List macro (LSTM) instruction 
List unreferenced symbols 
CLSTUR) instruction 
Load multiple instruction 
Load PSW instruction 
Local memory (registers) 
double precision floating 
point 
general rfurpose 
Single precision floating 
Fcoint 
Location counter, 
‘absolute 
impure 
Fure 
Logical expressions 


Machine instructions, 
mnemonics 

Main memory 

Message (MSG) instruction 

Mixed expressions 

Mixed mode computations 


N 


Name field 

NDEL 

NOCAL/32 instruction 

No cross (NCROS) instructicn 

No freeze (NFREZ) instruction 

No list conditionals (NLSTC) 
instruction 

No list (NLIST) instruction 

No list macro (NLSTM) 
instruction 

No list unreferenced symbols 
(NLSTU) instruction 

No RX3 (NORX3) instructicn 

No sequence check instructicn 

No squeeze (NOSQZ) instruction 

No warning (NWARN) instruction 


0 


Object code formats 

Operand fields, rules 

Operating instructions 
for 0S/32 

Oreraticn fields, 
mnemonics 
restrictions 

Optimization mode 

Crigin (ORG) instruction 


PQ 


Pass pause (PPAUS) instruction 
Pause (PAUSE) instruction 
Program (PROG) instructicn 


3-10 
1-1 
3-55 
2-2 
ye 


lol & ew 
' 
NOW iN CN bo 


a oo 
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Pregram segmentation 1-4 | Start option A-4 
Pregram status word (PSW), | Statements, 
condition code 1-2 | comment 3-4 
location counter 1-2 | instruction 232 
status descriptor 1-Z | Status descriftor 1-2 
Pure (PURE) instruction 3-43 l Store multirle instructicn 4-8 
Pure segments 1-4 Structure definition 
PURETCP 2-£ | instructions, 
| COMN 3-61 
R | ENDS 3-61 
STRUC 3-61 
| Structure initialization 
Register and immediate (RI) 1-6 | instructions, 
3-7 | BCATA 3-64 
Register and immediate one { EORG 2-64 
(RI1) 1-10 l Structure (STRUC) instructicn 3-6€1 
Register and immediate two Symbol definition instructicns 3-21 
(RI2) 1-11 | Symbolic representation 2-1 
Register and indexed storage | Symbols, 
eee - 
Register and indexed storage/ fullword 2-4 
register and indexed stcrage | global 2-3 
(PRXRX) 1-12 | 2-5 
; 3-8 { halfword a: 
Register and indexed storage | hexadecimal 2-4 
one (RX1) 1-8 implicit 2-3 
Register and indexed storage | System architecture, 
two (RX2) 1-9 | CPU 1-1 
Register and indexed storage { Main memory 1-1 
three (RX3) 1-10 l 
Registers, 
double precision floating | T 
point 1-2 | 
general purpose 1-2 | Target (TARGT) instructicn 3-47 
single precision floating 32-bit machine instructicns, 
point 12 | register and immediate cne 
Register-to-register (RR) 1-5 | (RI1) 4-10 
ee: | register and immediate two 
3-5 { (RI2) ae 
Relocatable programs 1-4 | register and indexed stcrage 
Relocatable quantities 2-2 l one (RX1) 1-8 
register and indexed stcrage 
S three (RX3) 1-10 
| register and indexed stcrage 
Scratch (SCRAT) instruction 3-54 | two (RX2) 19 
Sequence check (SQCHK) register and indexed 
instruction 3-54 storage/register and 
Short form (SF) instruction 1-7 | indexed storage (RXRX) 1242 
1-12 | register-to-register 1-8 
Simple if (IF) instructicn 3-60 | _ Short form (SF) 1-12 
16-bit machine instructicns, | Title instructions 3-65 
register and immediate (RI) 1-5 l 
register and indexed 
storage (RY) T= | UV 
register-to-register (KR) 1-5 | 
short form (SF) 1-5 | Unreferenced externals 
Source program, l instructions, 
comment statements 3-1 NUREX 3-56 
instruction statements 3-1 | UREX 3-56 
Space (SPACE) instruction 3-66 | 
Sequence checking instructions, see | WXYZ 
NOSEQ > 
SQCHK g=584 | Warming (WARN) instruction 3-€8 
Squeeze (SQUEZ) instruction 3-£0 | Width (WIDTH) instruction 3-66 
Squeeze related instructions, | WNTRY instructions 3-25 
ERSQZ 3-53 | 3-26 
NOSQZ 3-53 l WKTRN instructions 3-25 
NCRX3 3-63 3-26 
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